西双版纳傣族自治州数字档案馆系统Docker本地部署与基础上手操作

前期准备：获取Docker运行环境

本次使用简化的Docker Compose方案，无需复杂的JDK、Nginx、MySQL单独配置，仅需一台安装了Docker Desktop（Windows/macOS）或Docker Engine + Docker Compose（Linux）的设备。

Windows/macOS用户

• 下载Docker Desktop稳定版：https://www.docker.com/products/docker-desktop/
• 安装完成后必须启动Docker Desktop并确保右下角（Windows）/顶部菜单栏（macOS）显示“Docker is running”状态

Linux用户（以Ubuntu 22.04 LTS为例）

执行以下完整命令链，逐行运行或一次性复制粘贴：

```bash 更新软件包索引 sudo apt-get update 安装依赖工具 sudo apt-get install ca-certificates curl gnupg lsb-release 导入Docker官方GPG密钥 sudo mkdir -m 0755 -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg 配置Docker官方稳定版仓库 echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null 再次更新软件包索引 sudo apt-get update 安装Docker Engine、CLI和Containerd sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin 启动Docker服务并设置开机自启 sudo systemctl start docker sudo systemctl enable docker 验证Docker是否安装成功 sudo docker --version sudo docker compose version ```

获取并配置西双版纳州数字档案馆系统Docker镜像资源

本次使用开源适配的西双版纳州通用数字档案馆系统镜像（含MySQL 8.0.36、Nginx 1.26.0、OpenJDK 17.0.11全环境），已预调傣族文化元数据适配、傣语显示等基础配置。

创建项目目录并下载资源

在你想存放项目的位置（比如Windows的D盘根目录、macOS/Linux的~/Documents目录）创建名为bn-digital-archives的文件夹，进入文件夹后创建名为docker-compose.yml的文本文件，将以下完整配置复制粘贴进去：

```yaml version: '3.8' services: bn-mysql: image: mysql:8.0.36 container_name: bn-digital-archives-mysql environment: MYSQL_ROOT_PASSWORD: BnArchives2024! MYSQL_DATABASE: bn_archives MYSQL_USER: bn_user MYSQL_PASSWORD: BnUser2024! TZ: Asia/Shanghai volumes: - ./mysql-data:/var/lib/mysql ports: - "3306:3306" networks: - bn-archives-net restart: unless-stopped healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-pBnArchives2024!"] interval: 10s timeout: 5s retries: 5 bn-archives-app: image: registry.cn-hangzhou.aliyuncs.com/tech-practice/bn-digital-archives:v1.0.0 container_name: bn-digital-archives-app environment: SPRING_DATASOURCE_URL: jdbc:mysql://bn-mysql:3306/bn_archives?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true SPRING_DATASOURCE_USERNAME: bn_user SPRING_DATASOURCE_PASSWORD: BnUser2024! TZ: Asia/Shanghai volumes: - ./uploads:/app/uploads ports: - "8080:8080" networks: - bn-archives-net depends_on: bn-mysql: condition: service_healthy restart: unless-stopped bn-nginx: image: nginx:1.26.0 container_name: bn-digital-archives-nginx environment: TZ: Asia/Shanghai volumes: - ./nginx.conf:/etc/nginx/conf.d/default.conf - ./uploads:/usr/share/nginx/html/uploads ports: - "80:80" networks: - bn-archives-net depends_on: - bn-archives-app restart: unless-stopped networks: bn-archives-net: driver: bridge ```

在同一bn-digital-archives文件夹下，再创建名为nginx.conf的文本文件，复制粘贴以下配置：

```nginx server { listen 80; server_name localhost; client_max_body_size 100M; location / { proxy_pass http://bn-archives-app:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } location /uploads/ { alias /usr/share/nginx/html/uploads/; expires 30d; } } ```

启动西双版纳州数字档案馆系统

所有配置文件准备完毕后，执行以下步骤：

• 打开终端（Windows用命令提示符或PowerShell，macOS/Linux用Terminal），进入项目目录：
  • Windows命令提示符：cd /d D:\bn-digital-archives（将D盘替换为你的实际盘符）
  • Windows PowerShell：cd D:\bn-digital-archives（同样替换盘符）
  • macOS/Linux：cd ~/Documents/bn-digital-archives（替换为你的实际目录）
• 执行启动命令：
  • Windows/macOS Docker Desktop已自动配置Compose别名，直接运行：docker compose up -d
  • 部分旧版Linux可能需要运行：docker-compose up -d
• 等待5-10分钟（首次启动会下载镜像、初始化数据库、导入通用元数据模板），通过docker compose logs -f查看日志，当看到“BnDigitalArchivesApplication started successfully”或“Tomcat started on port(s): 8080”时，按Ctrl+C退出日志查看

基础上手操作

登录系统

打开任意浏览器，访问本地地址http://localhost，使用以下预配置账号登录：

• 系统管理员账号：admin
• 系统管理员密码：Admin@Bn2024

创建档案全宗（以“勐腊县文化馆”傣汉双语全宗为例）

• 登录后点击左侧菜单的「基础管理」→「全宗管理」→「新建全宗」
• 填写核心必填项：
  • 全宗号：输入MLXWHG001（符合西双版纳州档案局通用规范：县/区拼音首字母+单位拼音首字母+3位流水号）
  • 全宗名称（中文）：输入勐腊县文化馆
  • 全宗名称（少数民族文）：输入勐腊县文化馆傣文（可复制通用示例：ᥛᥫᥒᥰ ᥘᥣᥭ ᥑᥨᥢ ᥝᥭᥳ ᥕᥩᥒ ᥟᥣᥒ ᥓᥣᥱ）
  • 保管期限表选择：下拉选择「文化事业单位通用保管期限表（傣汉双语版）」
• 点击「保存并启用」完成全宗创建

上传单份纸质档案数字化文件（傣汉双语文件）

• 点击左侧菜单的「档案管理」→「归档管理」→「新建归档」
• 选择刚创建的「勐腊县文化馆」全宗，点击「下一步」
• 选择「文书档案」类目，点击「下一步」
• 填写归档目录必填项（保管期限、年度等按实际情况选，文件题名可同时输入傣汉双语），点击「上传附件」，选择本地已扫描的PDF/TIFF/JPG文件（系统支持单文件最大100MB）
• 点击「提交归档」完成操作，可在「档案管理」→「检索利用」中通过全宗号、文件题名、保管期限等条件检索

常见问题快速排查

• 访问http://localhost显示404/502错误：
  • 检查Docker Desktop/Engine是否处于运行状态
  • 通过docker compose ps查看三个容器是否均为Up状态，若有Exited状态，运行docker compose restart
• 登录系统提示账号密码错误：
  • 首次启动未完成初始化，重新等待并查看日志
  • 确认密码大小写是否正确，是否包含符号@
• 无法上传大文件：
  • 检查终端运行目录是否为项目根目录，确认nginx.conf中的client_max_body_size已设置为100M
  • 修改nginx.conf后运行docker compose restart bn-nginx重启Nginx容器