运维与排错

目录结构、日常维护（日志 / 启停 / 更新 / 备份）与常见问题。

目录结构

启动后会自动生成以下目录：

/www/arcartx/
├── arcartx-resource        # 可执行文件（前端已内嵌）
├── config.yaml             # 配置文件（可选）
├── data/
│   ├── database.db         # SQLite 数据库
│   └── .jwt_secret         # JWT 签名密钥（自动生成，注意保密）
└── uploads/                # 上传的资源文件

日常维护

查看日志

宝塔：进程守护管理器 → 对应进程 → 日志
systemd：

journalctl -u arcartx -f             # 实时日志
journalctl -u arcartx --since today  # 今日日志

启停服务

宝塔：在进程守护管理器中直接操作
systemd：

systemctl start  arcartx
systemctl stop   arcartx
systemctl restart arcartx
systemctl status arcartx

版本更新

停止服务；
替换可执行文件：

cp arcartx-resource-linux-amd64 /www/arcartx/arcartx-resource
chmod +x /www/arcartx/arcartx-resource

启动服务。

数据库与配置会自动保留，新版本启动时自动执行数据库迁移。

数据备份

定期备份以下文件即可：

cp /www/arcartx/data/database.db /备份路径/database.db.bak
cp /www/arcartx/config.yaml      /备份路径/config.yaml.bak

如需备份上传的资源文件：

tar czf /备份路径/uploads.tar.gz /www/arcartx/uploads/

数据恢复

停止服务后，将备份文件覆盖回原位置，重新启动即可。

常见问题

端口被占用

修改 config.yaml 中的 server.port，重启服务。

忘记管理员密码（重置后台）

停止服务，删除数据库文件，重启后会自动重建默认账号：

systemctl stop arcartx          # 或在宝塔中停止
rm /www/arcartx/data/database.db
systemctl start arcartx

重启后账号恢复为 admin / admin123。

此操作会清除所有 API 密钥、文件记录、在线配置等数据库内容；uploads/ 中已上传的资源文件不受影响，data/.jwt_secret 也会保留。

上传文件失败

检查 uploads/ 目录权限，确保运行用户可写：

chmod 755 /www/arcartx/uploads

若是文件超限，调大 config.yaml 的 storage.max_file_size；使用反向代理时还需同步调大 Nginx 的 client_max_body_size。

下载提示「流量已达上限」

全局每日流量已超过 traffic.daily_limit。可在后台「系统配置」临时调高，或等次日自动重置。

运维与排错

On this page