常见问题

常见的启动、存储、数据库、代理等问题

Port already in use

使用 --port 或 MEMOS_PORT 更换程序端口，重启服务。

Cannot write to the data directory

确认数据目录是否存在，并对 Memos 进程可写。你可以通过 --data 或 MEMOS_DATA 对其进行设置。

Database connection errors

检查数据库驱动和 DSN：

• MEMOS_DRIVER 应该是 sqlite、mysql、 postgres 其中之一。

• MEMOS_DSN 应该使用正确的 DSN format 格式

反向代理相关问题

如果你正在使用反向代理，请确认：

• MEMOS_INSTANCE_URL 是实例的公共访问连接

• 代理使用了标准的请求头（Host、X-Forwarded-*）

Docker 启动了但应用没有返回信息

请检查：

• docker logs memos

• 端口是否已经被占

• 挂载的数据目录是否可写

迁移后附件丢失

确认实例所使用的存储后端。如果附件在数据库之外存储，则需要单独进行迁移。