运行与维护
命令行帮助
在解压后的软件目录运行以下命令，查看支持的全部命令、帮助选项、环境变量、默认值及示例，无需先配置数据库。
./ilitebook-private --help
./ilitebook-private -h
./ilitebook-private help
./ilitebook-private snapshot --help省略命令默认启动网站。支持 serve、healthcheck、migrate、init-admin、reset-password、snapshot 和 help。配置通过环境变量提供，程序不自动读取 .env；不支持 --port 等配置选项。初始化数据库、创建管理员、重置密码及快照操作的环境变量要求请查看 --help，维护前确认数据库和备份位置。
日常启动与停止
cd /opt/ilitebook
./ilitebook-private serve
# 前台运行时，按 Ctrl+C 正常停止默认监听0.0.0.0:8000。在其他机器访问时，检查服务器访问规则。通过正式网址使用时配置域名和HTTPS，并正确设置APP_BASE_URL。
后台与开机启动
安装包 deploy/ilitebook.service 提供systemd示例。根据实际路径调整工作目录、可执行文件位置、环境文件和可写数据目录；使用独立服务账号运行。
sudo systemctl daemon-reload
sudo systemctl enable --now ilitebook
sudo systemctl status ilitebook
sudo journalctl -u ilitebook -n 100 --no-pager
sudo systemctl restart ilitebook常用环境变量
| 变量 | 用途 |
|---|---|
| HTTP_ADDR | 监听地址，默认0.0.0.0:8000 |
| APP_BASE_URL | 实际访问网址，同时用于授权校验 |
| DATABASE_CONFIG | 数据库配置文件，默认data/database.json |
| ATTACHMENT_DIR | 附件目录，默认data/attachments |
| DB_DRIVER、DB_DSN | 显式脚本部署连接，优先于配置文件，不与网页参数混用 |
| LOCALE_DIR、ASSET_DIR | 语言和界面资源目录 |
| TRUSTED_PROXIES | 可信代理地址范围 |
检查运行状态
curl --fail http://127.0.0.1:8000/healthz修改环境变量后重启服务。附件上传经过代理时，允许单个文件10MiB及少量表单开销，安装包Nginx示例已提供11MiB上传请求限制。
管理员密码恢复
普通用户忘记密码，请管理员在“用户管理”生成一次性临时密码。系统管理员自身忘记密码，由安装人员登录服务器，使用与运行服务相同的数据库配置执行 reset-password。软件不提供邮件重置。
cd /opt/ilitebook
read -r -p '管理员邮箱：' ADMIN_EMAIL
read -r -s -p '新密码（8–128字符）：' ADMIN_PASSWORD
echo
export ADMIN_EMAIL ADMIN_PASSWORD
DATABASE_CONFIG=/var/lib/ilitebook/database.json ./ilitebook-private reset-password
unset ADMIN_PASSWORD ADMIN_EMAIL以上为Bash示例，数据库配置及安装路径按实际位置调整。密码输入不回显。恢复仅适用于有效的系统管理员，成功后原会话及API令牌失效，账目和权限不变。