# LanQin Email 部署环境变量示例 # 用法:cp deploy/.env.example deploy/.env,然后修改 deploy/.env。 # 注意:.env 里不要写引号;真实密码、Secret Key 不要提交到 Git。 # ========================= # Docker 镜像 # ========================= # 单容器部署镜像。默认使用你的 GHCR 镜像。 # 本地源码构建请用:docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build LANQIN_IMAGE=ghcr.io/lanqin996/lanqin-email:latest # 多容器调试版镜像。只在 docker-compose.stack.yml 中使用。 LANQIN_API_IMAGE=ghcr.io/lanqin996/lanqin-email-api:latest LANQIN_WEB_IMAGE=ghcr.io/lanqin996/lanqin-email-web:latest LANQIN_POSTFIX_IMAGE=ghcr.io/lanqin996/lanqin-email-postfix:latest LANQIN_DOVECOT_IMAGE=ghcr.io/lanqin996/lanqin-email-dovecot:latest LANQIN_RSPAMD_IMAGE=ghcr.io/lanqin996/lanqin-email-rspamd:latest # ========================= # 对外访问地址 # ========================= # 邮件服务器主机名,一般填你的邮件域名,例如 mail.example.com。 # 会影响 Postfix myhostname、DNS 展示、邮件链接等。 LANQIN_PUBLIC_HOSTNAME=mail.example.com # Webmail 对外访问地址。生产环境建议使用 https。 LANQIN_PUBLIC_BASE_URL=https://mail.example.com # 邮件客户端 TLS 证书。用于 SMTP 465/587、IMAP 993、POP3 995。 # 生产环境请挂载真实证书,并确保域名包含 LANQIN_PUBLIC_HOSTNAME。 # 留空时 Dovecot/Postfix 会使用容器自带 localhost 自签证书;LanQin API 的 SMTP submission 不会启用。 LANQIN_TLS_CERT_FILE= LANQIN_TLS_KEY_FILE= # ========================= # 初始管理员 # ========================= # 第一次启动时会创建这个管理员账号。 LANQIN_ADMIN_EMAIL=admin@example.com # 生产环境必须改掉默认密码。 LANQIN_ADMIN_PASSWORD=ChangeMe123! # ========================= # API / 数据存储 # ========================= # API 监听地址。单容器里由 Nginx 反代到 127.0.0.1:8080。 LANQIN_ADDR=:8080 # 容器内数据目录。docker-compose.yml 已把 lanqin-data 挂到 /data。 LANQIN_DATA_DIR=/data # SQLite 数据库路径。 LANQIN_DB_PATH=/data/lanqin.db # Session Cookie 名称,一般不用改。 LANQIN_COOKIE_NAME=lanqin_session # 登录会话有效期,单位:小时。默认 168 小时,即 7 天。 LANQIN_SESSION_TTL_HOURS=168 # 是否允许非 HTTPS 下的 Cookie。生产环境建议 false;本地 HTTP 调试可改 true。 LANQIN_ALLOW_INSECURE_HTTP=false # ========================= # 注册与安全 # ========================= # 是否开放用户自行注册。 LANQIN_OPEN_REGISTRATION=false # 是否启用 2FA 功能总开关。 LANQIN_TWO_FACTOR_ENABLED=false # 是否启用 Cloudflare Turnstile 人机验证。 LANQIN_TURNSTILE_ENABLED=false # Turnstile Site Key,前端公开使用。未启用时可以留空。 LANQIN_TURNSTILE_SITE_KEY= # Turnstile Secret Key,服务端校验使用。未启用时可以留空。 LANQIN_TURNSTILE_SECRET_KEY= # ========================= # SMTP 发信 # ========================= # 单容器部署默认提交给容器内 Postfix。 # Split stack 会由 docker-compose.stack.yml 默认覆盖为 postfix:25。 # 如需在 split stack 使用外部 SMTP,可设置 LANQIN_STACK_SMTP_HOST / LANQIN_STACK_SMTP_PORT。 # 如果要走外部 SMTP,把 Host/Port/Username/Password 改成外部服务配置。 LANQIN_SMTP_HOST=127.0.0.1 LANQIN_SMTP_PORT=25 LANQIN_STACK_SMTP_HOST= LANQIN_STACK_SMTP_PORT= LANQIN_SMTP_USERNAME= LANQIN_SMTP_PASSWORD= # 外部 SMTP 要求 STARTTLS / TLS 时改 true;本机 Postfix 默认 false。 LANQIN_SMTP_REQUIRE_TLS=false # 第三方客户端 SMTP 提交,由 LanQin API 监听 587/465;启用前必须配置可读 TLS 证书。 LANQIN_SUBMISSION_ADDR= LANQIN_SUBMISSION_TLS_ADDR= LANQIN_SUBMISSION_MAX_MESSAGE_MB=35 # ========================= # 收件 / Maildir 同步 # ========================= # Dovecot Maildir 根目录。docker-compose.yml 已把 maildata 挂到这里。 LANQIN_MAILDIR_ROOT=/var/mail/vhosts # 扫描 Maildir 的间隔,单位:秒。 LANQIN_MAILDIR_SCAN_SECONDS=30 # Rspamd 从 SQLite 导出 DKIM 私钥到签名目录的间隔,单位:秒。 LANQIN_RSPAMD_DKIM_SYNC_SECONDS=60 # 无人收件开关。false:未注册邮箱默认拒收;true:未注册收件地址进入全部邮件。 LANQIN_CATCH_ALL_ENABLED=false # 用户是否可以在个人中心自助申请邮箱。 LANQIN_USER_MAILBOX_APPLY_ENABLED=false # 允许自助申请的域名 ID,多个用英文逗号分隔。建议在后台“系统设置 > 邮件”里配置。 LANQIN_USER_MAILBOX_DOMAIN_IDS= # 禁止自助申请的邮箱前缀,多个用英文逗号分隔。 LANQIN_RESERVED_MAILBOX_PREFIXES=admin,postmaster,abuse,hostmaster,webmaster,root,security,noreply,no-reply,mailer-daemon # Webmail 是否自动轮询刷新邮件。 LANQIN_MAIL_AUTO_REFRESH=true # 自动刷新间隔,单位:秒。 LANQIN_MAIL_REFRESH_SECONDS=30 # ========================= # 系统 # ========================= # 容器时区。 TZ=Asia/Shanghai