无需本地服务器搭建周口本地版轻量级档案管理系统指南

一、前期准备（3步完成）

1. 安装Docker Desktop

我们用Docker封装档案系统，无需手动配置PHP、MySQL等环境，Windows/Mac/Linux通用。

• Windows/Mac用户：直接访问Docker官网下载页安装免费社区版：https://www.docker.com/get-started/
• Linux（Ubuntu/Debian）用户：依次输入以下完整可复制命令：

```bash 更新软件源 sudo apt update 安装依赖 sudo apt install -y 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 再次更新并安装Docker sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin 启动并设置开机自启 sudo systemctl start docker sudo systemctl enable docker ```

2. 创建本地数据存储目录

避免Docker容器删除后档案数据丢失，必须单独挂载本地目录：

• Windows：在D盘或其他非系统盘根目录新建文件夹，命名为zhoukou_archive，再在里面建3个子文件夹dataconfigupload
• Mac：在用户目录下（Finder左侧小房子图标）新建文件夹zhoukou_archive，同样建3个子目录
• Linux：在/home/用户名下新建，或直接用/opt/zhoukou_archive：

```bash Linux通用创建目录（替换zhangsan为自己的用户名） sudo mkdir -p /home/zhangsan/zhoukou_archive/{data,config,upload} 设置权限（让Docker容器可读写） sudo chmod -R 777 /home/zhangsan/zhoukou_archive ```

3. 准备Docker Compose配置文件

在zhoukou_archive根目录下新建文本文件，命名为docker-compose.yml，注意文件名必须全小写、连字符，Windows用户别存成.txt后缀！完整可复制内容：

```yaml version: '3.8' services: mysql: image: mysql:5.7 container_name: zhoukou_archive_mysql restart: always environment: MYSQL_ROOT_PASSWORD: zhoukou123456 必须记住的root密码，可修改但别太简单 MYSQL_DATABASE: zhoukou_archive_db 档案系统数据库名 MYSQL_USER: zhoukou_archive_user 档案系统专用数据库账号 MYSQL_PASSWORD: zhoukou_archive_pwd 专用账号密码 volumes: 对应刚才创建的本地data目录，保存MySQL数据 - ./data:/var/lib/mysql ports: - "3307:3306" 本地端口用3307避免和已有MySQL冲突 command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci archive_system: image: teampass/teampass:3.0.0.23 选3.0稳定版Teampass（支持中文的免费轻量级档案管理系统） container_name: zhoukou_archive_system restart: always depends_on: - mysql environment: TP_DB_HOST: mysql:3306 TP_DB_NAME: zhoukou_archive_db TP_DB_USER: zhoukou_archive_user TP_DB_PASS: zhoukou_archive_pwd TP_URL: http://localhost:8080 本地访问地址，局域网访问可改成自己的IP volumes: 对应config和upload目录 - ./config:/var/www/html/teampass/includes - ./upload:/var/www/html/teampass/upload ports: - "8080:80" ```

二、启动并初始化档案系统（5步必走）

1. 启动Docker服务

• Windows/Mac：打开刚才安装的Docker Desktop，等左下角小鲸鱼图标变绿（稳定运行）
• Linux：刚才已经启动并设置自启了，直接用

2. 拉取并运行容器

打开终端（Windows用PowerShell或CMD，Mac用终端，Linux用终端），cd进入刚才的zhoukou_archive目录：

• Windows PowerShell（D盘的话）：

```powershell cd D:\zhoukou_archive ```

• Mac/Linux（刚才的/home/zhangsan/目录）：

```bash cd /home/zhangsan/zhoukou_archive ```

然后输入启动命令：

```bash docker-compose up -d ```

第一次运行会拉取Teampass和MySQL的镜像，大概需要3-10分钟（取决于网速），看到提示Creating zhoukou_archive_mysql ... done和Creating zhoukou_archive_system ... done就说明成功。

3. 等待MySQL完全初始化

MySQL第一次启动会初始化数据库，大概需要1-2分钟，别着急访问！可以在终端输入以下命令检查状态：

```bash docker logs zhoukou_archive_mysql ```

看到最后一行出现ready for connections（不带前缀Error）就可以了。

4. 网页端初始化Teampass

打开任意浏览器（Chrome/Edge/Firefox均可），访问刚才配置的地址：http://localhost:8080：

• 第一步：选择语言，直接选简体中文（Chinese Simplified）
• 第二步：检查环境，所有项目必须显示绿色的“OK”或“Enabled”，如果有红色项，回到终端检查刚才的目录权限和容器是否正常
• 第三步：数据库配置，直接用默认的（和docker-compose.yml里的一致），点击“下一步”
• 第四步：管理员配置，设置必填的初始管理员账号（建议用admin_zhoukou）、密码（必须至少8位，有大小写字母和数字，比如Zhoukou2024），其他信息可选填，点击“下一步”
• 第五步：系统安装，等待进度条走完，大概30秒
• 第六步：删除安装文件，回到刚才的终端，输入以下安全操作命令：

```bash 进入Teampass容器 docker exec -it zhoukou_archive_system bash 删除安装目录 rm -rf /var/www/html/teampass/install 退出容器 exit ```

5. 登录并设置基础权限

刷新浏览器页面，用刚才设置的管理员账号密码登录，进入系统后：

• 点击左侧菜单“用户管理”→“添加用户”，可以创建普通档案录入员、查看员账号
• 点击左侧菜单“文件夹管理”→“添加根文件夹”，命名为“周口档案库”，设置权限（只有录入员可编辑，查看员只读）

三、日常操作（2个核心场景）

1. 录入纸质/电子档案

• 纸质档案：先扫描成PDF/JPG格式，单个文件不超过100MB（可在config目录下的config.php修改，但不建议改太大）
• 电子档案：直接准备原始文件
• 具体步骤：登录系统→点击左侧“周口档案库”→点击右上角“+添加项目”→填写必填字段（项目名称、档案编号、保管期限、归档时间）→点击“文件”标签上传档案→点击“保存”

2. 查找并导出档案

• 快速查找：系统顶部有搜索框，支持按档案编号、项目名称、标签搜索
• 高级筛选：点击左侧“周口档案库”→点击右上角“筛选”→按保管期限、归档时间、创建人筛选
• 导出目录：点击左侧“周口档案库”→点击右上角“导出”→选择导出格式（CSV/Excel）

四、常见问题排查（3个高频）

1. 浏览器访问不了localhost:8080

• 检查Docker Desktop是否运行（小鲸鱼绿没绿）
• 检查容器是否运行：终端输入docker ps，看是否有zhoukou_archive_mysql和zhoukou_archive_system两个容器
• 如果没有，回到zhoukou_archive目录重新启动：docker-compose up -d

2. 上传大文件失败

先进入Teampass容器修改PHP配置：

```bash 进入容器 docker exec -it zhoukou_archive_system bash 找到PHP配置文件 cd /usr/local/etc/php/conf.d 新建上传限制配置文件 echo "upload_max_filesize = 500M" > uploads.ini echo "post_max_size = 500M" >> uploads.ini 重启容器 exit docker-compose restart ```

3. 忘记管理员密码

进入MySQL容器重置密码：

```bash 进入MySQL容器 docker exec -it zhoukou_archive_mysql bash 登录MySQL（用刚才docker-compose.yml里的MYSQL_ROOT_PASSWORD） mysql -uroot -pzhoukou123456 选择数据库 use zhoukou_archive_db; 重置admin_zhoukou的密码为Zhoukou2024 UPDATE teampass_users SET password = SHA2('Zhoukou2024', 256) WHERE login = 'admin_zhoukou'; 退出MySQL和容器 exit exit ```