cloudflare_temp_email/vitepress-docs/docs/zh/guide/worker-vars.md

Worker 变量说明

[!NOTE] 注意 通过 CLI 部署时的写法请参考 worker/wrangler.toml.template

必填变量

变量名	类型	说明	示例
DOMAINS	JSON	用于临时邮箱的所有域名, 支持多个域名	["awsl.uk", "dreamhunter2333.xyz"]
JWT_SECRET	文本/Secret	用于生成 jwt 的密钥, jwt 用于登录以及鉴权	xxx
ADMIN_PASSWORDS	JSON	admin 控制台密码, 不配置则不允许访问控制台	["123", "456"]
ENABLE_USER_CREATE_EMAIL	文本/JSON	是否允许用户创建邮箱, 不配置则不允许	true
ENABLE_USER_DELETE_EMAIL	文本/JSON	是否允许用户删除邮件, 不配置则不允许	true

后台相关变量

变量名	类型	说明	示例
PASSWORDS	JSON	网站私有密码, 配置后需要密码才能访问	["123", "456"]
DISABLE_ADMIN_PASSWORD_CHECK	文本/JSON	警告: 管理员控制台没有密码或用户检查	false

邮箱相关变量

变量名	类型	说明	示例
PREFIX	文本	新建 邮箱名称 的默认前缀，不需要前缀可不配置	tmp
MIN_ADDRESS_LEN	数字	邮箱名称 的最小长度	1
MAX_ADDRESS_LEN	数字	邮箱名称 的最大长度	30
ADDRESS_CHECK_REGEX	文本	邮箱名称 的正则表达式, 只用于检查	^(?!.*admin).*
ADDRESS_REGEX	文本	邮箱名称 替换非法符号的正则表达式, 不在其中的符号将被替换，如果不设置，默认为 [^a-z0-9], 需谨慎使用, 有些符号可能导致无法收件	[^a-z0-9]
DEFAULT_DOMAINS	JSON	默认用户可用的域名(未登录或未分配角色的用户)	["awsl.uk", "dreamhunter2333.xyz"]
DOMAIN_LABELS	JSON	对于中文域名，可以使用 DOMAIN_LABELS 显示域名的中文展示名称	["中文.awsl.uk", "dreamhunter2333.xyz"]
ENABLE_AUTO_REPLY	文本/JSON	允许自动回复邮件	true
DEFAULT_SEND_BALANCE	文本/JSON	默认发送邮件余额，如果不设置，将为 0	1

接受邮件相关变量

变量名	类型	说明	示例
BLACK_LIST	文本	黑名单，用于过滤发件人，逗号分隔	gov.cn,edu.cn
ENABLE_CHECK_JUNK_MAIL	文本/JSON	是否启用垃圾邮件检查，配合下列两个列表使用	false
JUNK_MAIL_CHECK_LIST	JSON	垃圾邮件检查配置, 任何一项 存在 且 不通过 则被判定为垃圾邮件	["spf", "dkim", "dmarc"]
JUNK_MAIL_FORCE_PASS_LIST	JSON	垃圾邮件检查配置, 任何一项 不存在 或者 不通过 则被判定为垃圾邮件	["spf", "dkim", "dmarc"]
FORWARD_ADDRESS_LIST	JSON	全局转发地址列表，如果不配置则不启用，启用后所有邮件都会转发到列表中的地址	["xxx@xxx.com"]
REMOVE_EXCEED_SIZE_ATTACHMENT	文本/JSON	如果附件大小超过 2MB，则删除附件，邮件可能由于解析而丢失一些信息	true
REMOVE_ALL_ATTACHMENT	文本/JSON	移除所有附件，邮件可能由于解析而丢失一些信息	true

Note

垃圾邮件检查 和 移除附件功能 需要解析邮件，免费版 CPU 有限，可能会导致大邮件解析超时

如果你想解析邮件能力更强

参考 配置 worker 使用 wasm 解析邮件

webhook 相关变量

变量名	类型	说明	示例
ENABLE_WEBHOOK	文本/JSON	是否启用 webhook	true
FRONTEND_URL	文本	前端地址，用于发送 webhook 的邮件 url	https://xxxx.xxx

Note

webhook 功能需要解析邮件，免费版 CPU 有限，可能会导致大邮件解析超时

如果你想解析邮件能力更强

参考 配置 worker 使用 wasm 解析邮件

用户相关变量

变量名	类型	说明	示例
USER_DEFAULT_ROLE	文本	新用户默认角色, 仅在启用邮件验证时有效	vip
ADMIN_USER_ROLE	文本	admin 角色配置, 如果用户角色等于 ADMIN_USER_ROLE 则可以访问 admin 控制台	admin
USER_ROLES	JSON	-	见下方
DISABLE_ANONYMOUS_USER_CREATE_EMAIL	文本/JSON	禁用匿名用户创建邮箱，如果设置为 true，则用户只能在登录后创建邮箱地址	true
NO_LIMIT_SEND_ROLE	文本	可以无限发送邮件的角色	vip

[!NOTE] USER_ROLES 用户角色配置说明

• 如果 domains 为空将使用 DEFAULT_DOMAINS
• 如果 prefix 为 null 将使用默认前缀, 如果 prefix 为空字符串将不使用前缀

通过用户界面部署时 USER_ROLES 请配置为此格式 [{"domains":["awsl.uk","dreamhunter2333.xyz"],"role":"vip","prefix":"vip"},{"domains":["awsl.uk","dreamhunter2333.xyz"],"role":"admin","prefix":""}]

CLI 部署时 USER_ROLES 请参考 worker/wrangler.toml.template 配置为此格式 [{ domains = ["awsl.uk", "dreamhunter2333.xyz"], role = "vip", prefix = "vip" }, { domains = ["awsl.uk", "dreamhunter2333.xyz"], role = "admin", prefix = "" }]

网页相关变量

变量名	类型	说明	示例
DEFAULT_LANG	文本	Worker 错误信息默认语言, zh/en	zh
TITLE	文本	自定义前端页面网站标题，支持 html	Custom Title
ANNOUNCEMENT	文本	自定义前端页面公告，支持 html	Custom Announcement
COPYRIGHT	文本	自定义前端界面页脚文本，支持 html	Dream Hunter
ADMIN_CONTACT	文本	admin 联系方式，可配置任意字符串, 不配置则不显示	xxx@gmail.com
DISABLE_SHOW_GITHUB	文本/JSON	是否显示 GitHub 链接	true
CF_TURNSTILE_SITE_KEY	文本/Secret	Turnstile 人机验证配置	xxx
CF_TURNSTILE_SECRET_KEY	文本/Secret	Turnstile 人机验证配置	xxx

Telegram Bot 相关变量

变量名	类型	说明	示例
TG_MAX_ADDRESS	数字	telegram bot 最多绑定邮箱数量	5
TG_BOT_INFO	文本	可不配置，telegram BOT_INFO，预定义的 BOT_INFO 可以降低 webhook 的延迟	{}

Note

Telegram 功能需要解析邮件，免费版 CPU 有限，可能会导致大邮件解析超时

如果你想解析邮件能力更强

参考 配置 worker 使用 wasm 解析邮件

其他变量

变量名	类型	说明	示例
ENABLE_ANOTHER_WORKER	文本/JSON	是否开启其他 worker 处理邮件	false
ANOTHER_WORKER_LIST	JSON	- 其他 worker 处理邮件的配置，可以配置多个其他 worker - 通过关键词筛选，调用对应绑定的 worker 的方法（默认方法名为 rpcEmail） - keywords必填，否则 worker 将不会被触发	见下方

Note

ANOTHER_WORKER_LIST 的配置示例

#ANOTHER_WORKER_LIST ="""
#[
#    {
#        "binding":"AUTH_INBOX",
#        "method":"rpcEmail",
#        "keywords":[
#            "验证码","激活码","激活链接","确认链接","验证邮箱","确认邮件","账号激活","邮件验证","账户确认","安全码","认证码","安全验证","登陆码","确认码","启用账户","激活账户","账号验证","注册确认",
#            "account","activation","verify","verification","activate","confirmation","email","code","validate","registration","login","code","expire","confirm"
#        ]
#    }
#]
#