档案软件单机版本地离线运行 零门槛全流程部署实操指南

前期准备：获取安装包与环境检查

本文选用完全开源、可永久离线运行的档案管理程序，无联网授权要求，所有数据存储在本地，满足隐私、涉密档案的管理需求，所有步骤不需要公网访问，零门槛可落地。所需安装包直接通过以下地址下载：

• 64位Windows绿色免安装压缩包：https://github.com/shaonianzhentan/archive-box/releases/download/v1.2.0/ArchiveBox-win-x64.zip
• Mac/Linux安装包从官方发布页获取：https://github.com/shaonianzhentan/archive-box/releases

环境要求：Windows系统不需要额外安装任何依赖，解压即可运行；Mac系统仅需要调整开发者权限，后续步骤会说明；Linux系统仅要求glibc版本≥2.17，绝大多数主流发行版都满足该要求。

第一步：解压与基础配置（全系统通用）

1. 选择一个剩余空间≥1GB的本地非系统盘（不要放在系统盘的Program Files目录，避免权限不足导致写入失败），新建文件夹命名为LocalArchive，将下载的压缩包内所有文件解压到该文件夹中。

2. 在解压后的文件夹内找到配置文件 config.ini，使用系统自带的记事本打开，删除原有内容后，直接复制粘贴以下完整配置，不需要修改任何内容（如果需要更换端口，仅修改最后一行的port值即可）：

``` [base] 本地档案数据存储路径，所有文件存在该目录 data_path = ./archive_data 开启本地登录验证，避免档案被随意查看 enable_login = true 默认账号密码，部署完成后可自行修改 username = admin password = admin123 本地服务端口，冲突时可更换 port = 8089 ```

修改完成后保存config.ini文件，基础配置步骤完成。

第二步：启动服务，验证离线运行状态

Windows系统启动步骤

• 进入LocalArchive文件夹，找到start.bat文件
• 右键点击该文件，选择「以管理员身份运行」（避免权限不足导致数据写入失败）
• 等待2-3秒，命令行窗口显示「服务启动成功」即为正常
• 保持命令行窗口不关闭，打开任意浏览器，在地址栏输入 http://localhost:8089 回车访问

Mac系统启动步骤

• 打开终端，进入解压后的文件夹路径，例如解压在桌面则输入：cd ~/Desktop/LocalArchive
• 给执行文件添加运行权限：输入命令 chmod +x ./ArchiveBox
• 启动服务：输入 ./ArchiveBox，如果弹出「无法验证开发者」提示，进入「系统设置→隐私与安全性」，拉到页面最下方点击「允许 anyways」，重新启动即可
• 打开浏览器访问 http://localhost:8089

Linux系统启动步骤

• 进入解压目录，执行以下命令： ``` chmod +x ./ArchiveBox nohup ./ArchiveBox > archive.log 2>&1 & ```
• 本地访问直接输入http://localhost:8089，服务器部署则访问服务器IP加8089端口即可

如果能正常打开登录页面，输入默认账号admin、密码admin123成功登录，说明档案软件已经成功在本地单机离线运行，部署完成。

第三步：常用设置与数据维护

1. 修改默认密码：登录系统后，点击右上角头像，选择「修改密码」，输入原密码后设置新的强密码保存即可，所有密码信息仅存储在本地，不会外传。

2. 开机自动启动设置：

• Windows：按下Win+R，输入shell:startup回车，打开开机启动文件夹，将start.bat的快捷方式复制到该文件夹即可，下次开机会自动启动服务
• Linux：编辑/etc/rc.local文件，在exit 0前添加以下内容，保存后给rc.local添加执行权限即可： ``` cd /你的解压路径/LocalArchive nohup ./ArchiveBox > archive.log 2>&1 & ```

3. 数据备份：直接完整复制LocalArchive文件夹到外接硬盘即可完成全量备份，还原时直接解压启动就能正常使用，全程不需要联网，不需要迁移云端数据。

常见卡壳问题解决

• 提示端口被占用无法启动：打开config.ini，将port值修改为8090、8091等其他未占用端口，保存后重新启动服务即可
• 启动后命令行窗口自动关闭：一般是杀毒软件误杀了执行文件，将LocalArchive文件夹添加到杀毒软件白名单，重新解压即可，该软件为开源项目，无任何恶意代码
• 打开页面提示无法访问：检查系统防火墙是否拦截了对应端口，关闭拦截或者更换端口后重试即可

部署完成后，只要不删除本地文件，就可以永久离线运行，不需要任何联网验证、付费授权，所有档案数据完全可控。