3 运维指令总览

LynxDrive 的全部运维动作都收在一个入口：lynxdrive-ctl。不需要记住分散在各处的系统命令，也不需要碰配置文件。

使用约定

三条约定先记住：改配置、管账号、控制服务需要 root 权限，命令前加 sudo；查看类命令不带参数就是读取当前值，普通账号也能执行；写操作立即生效，涉及访问方式的会自动重启服务，中断通常只有几秒。

访问配置类

port、addr、root 三条互为补充：不带参数回显当前值，带参数写入新值并重启服务。端口只接受数字；地址一般保持 0.0.0.0，做网段隔离时才绑定具体 IP；更换根目录前请先看《访问配置》一章的提醒——新目录会被创建并接管，旧文件不会自动搬迁。

账号管理类

user add 创建账号，默认是普通用户（具备基础浏览与下载能力），需要管理员权限时追加 --admin；user passwd 只重置口令，不改变权限与其他设置。账号已存在时新增会报错，此时应改用重置口令；用户名写错时同理。创建完成后线下告知本人，并要求首次登录修改。

服务控制类

start、stop、restart 同时作用于主服务与看门狗。stop 之后页面立刻不可访问，适合短时维护；restart 是排查卡顿的首选动作，但不要把它当常规手段——一天内需要重启多次，请按《运行状态、看门狗与故障自愈》的思路找根因。

状态与日志类

status 输出主服务、看门狗、端口、根目录与端口探测，适合截图留档；info 追加本机访问地址，适合发给同事；logs 默认最后 50 行，logs 200 表示查看最后 200 行，看门狗的检查与重启记录同样会出现在其中。

重建初始化

init 是为交付与恢复场景准备的。在已运行的系统上执行，它会检测到系统已初始化并直接退出，不会动任何数据；只有显式使用 FORCE=1 lynxdrive-ctl init 才会真正重建——这会重置访问配置与管理员口令，仅在设备转交、恢复出厂或环境彻底重建时使用，执行前确认文件数据已有备份。重建时可用环境变量 LX_ADDR、LX_ROOT 预置监听地址与数据目录。

错误与脚本化

所有命令出错时以 [错误] 开头给出原因，并以非零状态退出，脚本化调用可以直接判断返回值。改完任何一项配置，建议先跑一次 status 确认端口探测正常，再通知同事更新地址。