站点设置

在管理员后台的「站点设置」标签页中,可以配置系统的全局参数。修改后点击「保存设置」按钮生效。
存储与限制
默认存储限额(MB)
- 字段:
default_storage_limit_mb
- 说明: 新注册用户的默认存储空间上限,单位为 MB
- 默认值: 1024(即 1 GB)
- 备注: 管理员可以在用户管理中为单个用户设置不同的限额
邮件设置
发件人邮箱
- 字段:
email_from
- 说明: 系统发送邮件时使用的发件人邮箱地址
- 示例:
no-reply@example.com
发件人名称
- 字段:
email_from_name
- 说明: 邮件中显示的发件人名称
- 默认值:
思源笔记分享
验证码邮件主题
- 字段:
email_subject
- 说明: 发送邮箱验证码时的邮件标题
- 默认值:
验证码
重置密码邮件主题
- 字段:
email_reset_subject
- 说明: 发送密码重置码时的邮件标题
- 默认值:
重置密码
站点显示
ICP 备案号
- 字段:
site_icp
- 说明: 中国网站 ICP 备案编号,会显示在分享页面底部
- 示例:
京ICP备xxxxxxxx号
- 留空: 不显示备案信息
联系邮箱
- 字段:
site_contact_email
- 说明: 公开的联系邮箱地址,会显示在分享页面底部
- 留空: 不显示联系邮箱
网站地址
- 字段:
site_base_url
- 说明: 固定分享链接的前缀地址,解决以下场景的问题:
- 容器使用 HTTP 但反向代理使用 HTTPS,导致生成的分享链接为 HTTP
- 使用 IP+端口部署时,分享链接缺少端口号
- 示例:
https://share.example.com
- 留空: 系统自动检测(大多数情况下可正常工作)
内容管理
违禁词
- 字段:
banned_words
- 说明: 违禁词列表,多个词之间用竖线(
|)分隔
- 作用范围:
- 分享上传的文档内容
- 分享页面的评论内容
- 触发违禁词的内容将被拦截
- 示例:
违禁词1|违禁词2|违禁词3
自定义 HTML Head
- 字段:
site_head_html
- 说明: 向页面
<head> 中插入自定义的 HTML 代码
- 用途: 添加统计脚本(如 Google Analytics、百度统计)、自定义 meta 标签等
- 示例:
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXX"></script>
功能开关
允许注册
- 字段:
allow_registration
- 说明: 控制是否允许新用户自助注册
- 关闭后: 注册页面不可用,只能由管理员在后台手动创建账号
开启验证码
- 字段:
captcha_enabled
- 说明: 在登录和注册页面显示图形验证码
- 作用: 防止机器人自动注册和暴力破解
开启邮箱验证
- 字段:
email_verification_enabled
- 说明: 注册时要求邮箱验证码验证
- 前提: 需要先开启 SMTP 功能
开启 SMTP
- 字段:
smtp_enabled
- 说明: 启用 SMTP 发送邮件功能
- 影响功能: 邮箱验证码登录、注册邮箱验证、密码重置、评论通知、换绑邮箱
SMTP 配置
开启 SMTP 后需要配置以下参数:
SMTP 服务器
- 字段:
smtp_host
- 说明: SMTP 服务器的主机名
- 示例:
smtp.gmail.com、smtp.qq.com、smtp.163.com
SMTP 端口
- 字段:
smtp_port
- 说明: SMTP 服务器的端口号
- 常用值: 587(TLS)、465(SSL)、25(无加密)
- 默认值: 587
加密方式
- 字段:
smtp_secure
- 说明: SMTP 连接的加密方式
- 选项: 无加密(None)/ TLS / SSL
SMTP 用户名
- 字段:
smtp_user
- 说明: SMTP 认证的用户名,通常为邮箱地址
SMTP 密码
- 字段:
smtp_pass
- 说明: SMTP 认证的密码或授权码
- 备注: 部分邮箱服务商(如 QQ 邮箱、163 邮箱)需要使用授权码而非登录密码
SMTP 测试

配置完成后,可以使用 SMTP 测试功能验证配置是否正确:
- 在「测试邮箱」输入框填写一个邮箱地址
- 点击「发送测试邮件」按钮
- 系统会尝试发送一封测试邮件
- 成功时显示发送成功提示
- 失败时显示具体的错误信息,便于排查配置问题
评论