先找对配置入口
配置所在的位置决定修改入口及生效时机。启动参数选择监听地址和数据库;应用设置控制实例策略与提供方。部署管理文件可以在进程运行期间覆盖数据库中保存的应用设置,移除文件并重启后才恢复使用数据库值。
| 层级 | 示例 | 修改方式 |
|---|---|---|
| 命令行 / 环境变量 | MEMOS_ADDR、MEMOS_PORT、MEMOS_DATA、MEMOS_DRIVER、MEMOS_DSN | 修改进程配置并重启 |
| 实例设置 | 访问策略、存储、通知和身份提供方 | 由有权限的管理员操作 |
| 部署文件 | 受支持的实例设置和身份提供方 | 修改挂载文件并重启;覆盖期间界面写入会被拒绝 |
| 个人设置 | 偏好、令牌与 Webhook | 在对应账号的设置中修改 |
本地运行时显式指定目录
按运行二进制完成构建后,学习配置时使用独立数据目录。原生进程默认端口为 8081,打包容器设置为 5230。显式指定回环地址可避免开发进程监听其他网卡。迁移到服务管理器前,先阅读启动参数与环境变量。
./build/memos --help
unset MEMOS_UNIX_SOCK MEMOS_DEMO
./build/memos --addr 127.0.0.1 --port 8081 --driver sqlite --dsn '' --data ./dev-data一次修改一类配置
记录原先的非秘密配置;涉及持久化的修改应先备份。修改存储后,上传并读取新的小附件;修改认证后,保留恢复入口并用独立测试账号登录;修改访问策略后,用退出登录的浏览器会话检查。界面显示保存成功,并不等于底层服务已经可用。
排查常见配置问题
字段只读时查看部署管理的配置;启动无法连接时查看数据库配置;上传或下载失败时查看附件存储。错误报告中不要粘贴数据库凭据或提供方密钥,应说明配置组、去敏后的错误,以及问题是否从重启后开始出现。