从零快速搭建数字档案馆系统档案网站实操全流程指南

环境准备

安装Docker与Docker Compose

执行以下国内加速命令安装Docker：

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

安装适配国内源的Docker Compose 2.20.2版本：

sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

验证安装是否成功：

docker --version && docker-compose --version

搭建核心档案网站服务

克隆项目仓库

在终端依次执行以下命令，拉取预配置好的极简数字档案馆项目：

git clone https://gitee.com/tech-expert/digital-archive-demo.git

cd digital-archive-demo

配置数据库连接（完整复制使用）

编辑项目根目录下的.env文件，替换原有内容为以下完整配置：

关键提醒：该文件权限必须设为600，执行chmod 600 .env避免数据库信息泄露

``` DB_ENGINE=django.db.backends.mysql DB_NAME=archive_db DB_USER=archive_user DB_PASS=Archive@2024! DB_HOST=db DB_PORT=3306 SECRET_KEY=django-insecure-$(openssl rand -hex 32) DEBUG=True ALLOWED_HOSTS= ```

一键启动服务

执行Docker Compose构建并启动所有依赖服务：

docker-compose up -d --build

等待30秒后，执行docker ps验证，确保web、db、nginx三个容器状态均为Up且运行中。

档案上传与基础功能配置

创建管理员账号

执行以下命令进入Web容器并创建超级管理员：

docker exec -it archive_web python manage.py createsuperuser

按提示依次输入：用户名（如admin）、邮箱（可随便填）、密码（长度≥8，需包含大小写字母+数字+特殊字符）。

配置档案上传存储路径

编辑项目内的settings.py文件，找到MEDIA相关配置，替换为：

``` MEDIA_ROOT = '/app/media/archive_files' MEDIA_URL = '/media/' ```

执行命令重启Web容器使配置生效：docker-compose restart web

上传测试档案

打开浏览器访问后台地址：http://你的服务器IP/admin/，登录刚才创建的管理员账号，点击左侧「档案」→「添加档案」，上传任意PDF/图片格式的测试文件，填写档案名称、分类后点击保存。

网站公开访问与调试

配置Nginx反向代理（公开访问核心步骤）

编辑nginx/conf.d/archive.conf文件，替换为以下完整配置（将「你的域名或服务器IP」替换为实际访问地址）：

``` server { listen 80; server_name 你的域名或服务器IP; location / { proxy_pass http://web:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location /media/ { alias /app/media/archive_files/; } } ```

重启Nginx容器应用配置：docker-compose restart nginx

验证公开访问

在浏览器地址栏输入你的服务器IP或域名，即可看到基础的数字档案列表页面，点击档案名称可在线查看内容。

常见问题处理

• 服务启动失败：执行docker logs archive_web查看报错，若提示端口冲突，修改docker-compose.yml内的端口映射值，改为未占用端口
• 档案无法上传：检查media文件夹权限，执行docker exec archive_web chmod -R 755 /app/media
• 无法访问站点：检查服务器安全组是否开放80端口，阿里云/腾讯云需同步在控制台配置安全组规则