移动端部署文书档案系统：零门槛实操分步指南

一、前置准备

需工具：1. 预装Docker和Docker Compose的PC（推荐Ubuntu20.04 LTS）；2. 文书档案系统源码包（下载地址：https://github.com/leanote/leanote/releases/download/v2.7.0/leanote-linux-amd64-v2.7.0.tar.gz）；3. 安卓/苹果移动设备，可连接同PC局域网或公网

二、PC端Docker环境配置

2.1 安装Docker

执行镜像加速安装命令：

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

验证安装：

```docker --version```

```docker-compose --version```

2.2 配置Docker镜像加速

创建配置目录：```sudo mkdir -p /etc/docker```

写入加速配置：

```sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"] } EOF```

重启Docker生效：

```sudo systemctl daemon-reload```

```sudo systemctl restart docker```

三、部署文书档案系统

3.1 解压源码包

假设源码包下载至~/downloads，执行：

```cd ~/downloads && tar -zxvf leanote-linux-amd64-v2.7.0.tar.gz -C /opt/ams```

进入部署目录：```cd /opt/ams```

3.2 编写Docker Compose配置文件

新建docker-compose.yml，完整内容：

```version: '3' services: ams: build: . ports: - "8080:9000" volumes: - ./data:/opt/leanote/data environment: - TZ=Asia/Shanghai restart: always```

3.3 构建并启动容器

执行构建启动命令：```docker-compose up -d --build```

验证运行状态：```docker ps | grep ams```

正常会显示状态为Up，端口映射正确

四、移动端访问配置

4.1 局域网访问（同WiFi）

获取PC局域网IP：执行```ip a | grep inet | grep -v 127.0.0.1```，找到当前网卡的inet地址（如192.168.1.105）；

移动端浏览器输入：http://192.168.1.105:8080，即可直接访问系统

4.2 公网访问（外部网络）

需用frp做内网穿透，步骤如下：

1. 下载frp稳定版：https://github.com/fatedier/frp/releases/download/v0.52.3/frp_0.52.3_linux_amd64.tar.gz

2. 解压至指定目录：```tar -zxvf frp_0.52.3_linux_amd64.tar.gz -C /opt/frp```

3. 新建frpc.ini配置文件，内容：

```[common] server_addr = 你的frp服务器IP server_port = 7000 token = 自定义密文 [ams] type = tcp local_ip = 127.0.0.1 local_port = 9000 remote_port = 8080```

4. 启动frp客户端：```cd /opt/frp && ./frpc -c frpc.ini```

5. 移动端输入：http://frp服务器IP:8080，即可公网访问系统

五、初始配置与测试

1. 首次登录：默认账号admin，密码abc123，登录后立即修改密码；

2. 移动端测试：上传1份文档，验证PC端、移动端均可查看，若出现乱码，修改docker-compose.yml的环境变量添加```- LANG=zh_CN.UTF-8```；

3. 权限配置：后台添加「移动端用户组」，配置文档查看、上传权限，符合档案管理要求；

4. 日志查看：执行```docker logs ams```，排查系统运行异常

六、常见问题排查

• 端口被占用：执行```netstat -tulpn | grep 8080```，杀死占用进程，或修改docker-compose.yml的端口映射为8081:9000
• 容器启动失败：检查配置文件是否有语法错误，或执行```docker rm ams && docker-compose up -d```重建容器
• 移动端无法访问：局域网检查PC防火墙是否开放8080端口，执行```sudo ufw allow 8080```；公网检查frp是否启动，远程服务器端口7000是否开放