1 访问配置：地址、端口与数据目录

三项配置决定了同事怎么连上来：监听地址、端口、数据根目录。多数单位不需要改动，只有在端口冲突、多网段隔离或更换存储盘时才需要调整。

默认值与查看方式

出厂默认监听 0.0.0.0（所有网卡都可访问）、端口 6557、根目录 /home/lynx/lynxdrive。不带参数执行 lynxdrive-ctl port、lynxdrive-ctl addr、lynxdrive-ctl root 即可分别回显当前值，排障时先确认这三项，能省掉一半猜测。

修改端口

sudo lynxdrive-ctl port 8080。端口只接受数字，填错会直接报错拒绝；修改后服务自动重启，几秒内生效。访问地址随之变化，需要通知所有同事更新书签，之前发出的分享链接也要重新生成。

修改监听地址

sudo lynxdrive-ctl addr 192.168.1.20 让服务只监听指定网卡，适合多网段隔离的场景。需要注意，绑定具体 IP 之后其他网段将无法访问；没有隔离需求时保持 0.0.0.0 最省事。设备更换 IP 或网卡顺序变化时，绑定具体地址的配置会失效，这是“昨天还能打开、今天打不开”的常见原因之一。

更换数据目录

sudo lynxdrive-ctl root /data/share 会创建新目录并接管，但不会搬迁旧数据。原有文件仍留在旧路径下，需要事先在新旧目录之间手工迁移，否则同事们会以为文件“消失”了。正确顺序是：先停写入、迁移文件、再改配置、最后验证抽查。

变更的连带影响

改端口影响书签与分享链接；改地址影响可达网段；改根目录影响所有目录结构。任何一项变更后，建议先跑一次 lynxdrive-ctl status 确认端口探测正常，再发通知。通知里写清楚“新地址、生效时间、旧链接失效”，比事后逐个解释高效得多。

配置维护原则

配置由系统统一维护，一律通过命令修改，不要手工编辑配置文件。手工改动与系统记录不一致时，后续排障和升级都会变得难以判断。改动前记录原值，是成本最低的回滚手段。