手机端轻量文书档案系统全流程部署实操指南 零门槛直接落地

前置准备

硬件要求

安卓7.0及以上版本手机，剩余存储≥10G，运行内存≥4G，仅支持安卓设备，iOS设备因权限限制无法部署

软件准备

下载Termux安装包：https://f-droid.org/repo/com.termux_118.apk，下载后直接安装，若提示风险忽略即可，为官方开源版本无恶意代码

步骤1：Termux基础环境初始化

1. 打开安装好的Termux，执行以下命令申请存储权限，弹出权限申请点击允许：

``` termux-setup-storage ```

2. 执行命令切换国内软件源，解决下载慢的问题：

``` termux-change-repo ```

弹出选择界面后，用音量键上下移动光标，回车键确认，全选「清华大学镜像源」即可，完成后执行更新命令：

``` pkg update && pkg upgrade -y ```

若安装过程中出现提示，直接按回车确认即可，等待更新完成。

步骤2：安装部署所需依赖

执行以下命令一键安装web服务、php runtime、数据库等所有依赖：

``` pkg install nginx php8.2 php8.2-fpm php8.2-sqlite3 php8.2-mbstring git -y ```

等待安装完成，无报错即可进入下一步。

步骤3：拉取移动端适配版文书档案系统代码

执行以下命令拉取开源轻量文书档案系统代码，该系统已完全适配移动端触摸操作，支持分类归档、关键词检索、权限管理、多格式文件上传：

``` cd /data/data/com.termux/files/home && git clone https://gitee.com/lightarch/light-archive-system.git archive mv archive/ /data/data/com.termux/files/usr/share/nginx/html/ ```

步骤4：配置web服务（核心步骤）

1. 编辑nginx配置文件，执行以下命令打开编辑器：

``` vi /data/data/com.termux/files/usr/etc/nginx/nginx.conf ```

按i进入编辑模式，删除原有所有内容，粘贴以下完整配置：

``` worker_processes 1; events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; keepalive_timeout 65; server { listen 8080; server_name localhost; root /data/data/com.termux/files/usr/share/nginx/html; index index.php index.html index.htm; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass unix:/data/data/com.termux/files/usr/var/run/php-fpm8.2.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } location ~ /\.ht { deny all; } location ~ /data/ { deny all; } } } ```

粘贴完成后按ESC，输入:wq回车保存退出。

2. 测试配置是否正确，执行：

``` nginx -t ```

显示test is successful即为正常，若报错请检查配置文件内容是否粘贴完整。

3. 启动nginx和php服务：

``` nginx php-fpm8.2 ```

步骤5：系统初始化与访问

1. 本机访问：打开手机浏览器输入http://127.0.0.1:8080即可进入系统。

2. 局域网其他设备访问：执行以下命令查看手机局域网IP：

``` ifconfig | grep inet ```

找到wlan0对应的inet地址，例如192.168.3.12，同局域网下的其他手机、电脑输入http://[你的手机IP]:8080即可访问。

3. 初始登录账号：管理员账号admin，密码123456，首次登录会强制修改密码，按照提示操作即可。

常用配置与问题排查

1. 开机自启配置

执行以下命令安装自启组件：

``` pkg install termux-boot -y ```

创建自启脚本：

``` mkdir -p ~/.termux/boot vi ~/.termux/boot/start-archive.sh ```

粘贴以下内容：

``` !/data/data/com.termux/files/usr/bin/sh nginx php-fpm8.2 ```

保存退出后执行赋予执行权限：

``` chmod +x ~/.termux/boot/start-archive.sh ```

最后到手机系统设置的应用管理中，给Termux开启自启动权限和后台运行权限，重启手机后服务会自动启动。

2. 上传文件大小限制调整

默认单文件上传限制为2M，如需调整执行以下命令编辑php配置：

``` vi /data/data/com.termux/files/usr/lib/php8.2/php.ini ```

分别找到以下两个参数修改为对应值，支持20M以内文件上传：

• upload_max_filesize = 20M
• post_max_size = 25M

保存退出后重启php服务生效：

``` pkill php-fpm8.2 && php-fpm8.2 ```

3. 数据备份

执行以下命令一键备份所有档案数据到手机内置存储根目录，可随时导出到其他设备：

``` cp /data/data/com.termux/files/usr/share/nginx/html/data/archive.db /sdcard/archive_backup_$(date +%Y%m%d).db ```

4. 常见问题排查

• 访问提示404：检查nginx配置是否正确，重启nginx执行nginx -s reload
• 访问提示502：检查php-fpm是否启动，重新执行php-fpm8.2
• 局域网其他设备访问不到：检查手机和其他设备是否连接同一个WiFi，关闭手机VPN即可