文档配置

Rust · 0.1.0

配置

区分启动参数、实例管理与个人设置,再逐层修改和验证。

先找对配置入口

配置所在的位置决定修改入口及生效时机。启动参数选择监听地址和数据库;应用设置控制实例策略与提供方。部署管理文件可以在进程运行期间覆盖数据库中保存的应用设置,移除文件并重启后才恢复使用数据库值。

层级示例修改方式
命令行 / 环境变量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

一次修改一类配置

记录原先的非秘密配置;涉及持久化的修改应先备份。修改存储后,上传并读取新的小附件;修改认证后,保留恢复入口并用独立测试账号登录;修改访问策略后,用退出登录的浏览器会话检查。界面显示保存成功,并不等于底层服务已经可用。

排查常见配置问题

字段只读时查看部署管理的配置;启动无法连接时查看数据库配置;上传或下载失败时查看附件存储。错误报告中不要粘贴数据库凭据或提供方密钥,应说明配置组、去敏后的错误,以及问题是否从重启后开始出现。

本节指南