Phoenix-MD配置手册:PREFIX、MODE、SUDO等10个关键配置项深度解析
Phoenix-MD配置手册:PREFIX、MODE、SUDO等10个关键配置项深度解析
Phoenix-MD 是一款简单却功能强大的 WhatsApp 多设备机器人,它的几乎所有行为都由 config.js 这一个文件控制。本手册带你逐个吃透 SESSION_ID、PREFIX、MODE、SUDO 等 10 个核心配置项的含义、默认值和正确写法,帮你把这只「凤凰」调教成自己想要的样子 🐦🔥
快速上手:Phoenix-MD 机器人配置在哪里改?
所有配置集中定义在 config.js,每一项都遵循同一个套路:
配置项: process.env.环境变量名 || 默认值
也就是说你不需要改动代码,只需通过环境变量覆盖默认值。实际使用中有三种常见方式:
| 方式 | 适用场景 | 说明 |
|---|---|---|
config.env 文件 |
本地 / Termux 部署 | 项目启动时会自动读取该文件(见 config.js) |
| 平台环境变量面板 | Heroku、Render、Koyeb 等 | 面板字段由 app.json 自动定义,直接填值即可 |
| 修改 config.js 默认值 | 想固化个人偏好 | 注意文件末尾标注了 ⚠️ 警告区,不要动 |
配置改完后重启机器人即可生效(本地可用 npm start,脚本定义在 package.json)。
1. SESSION_ID:机器人的「身份证」
SESSION_ID=你的配对凭据
- 定义位置:config.js
- 必填项 ⚠️,没有它机器人无法登录 WhatsApp
- 获取方式:在项目的 session 配对页面扫码生成,然后填到这里
- 登录成功后,会话数据会缓存到 lib/session/abhi.js,之后重启无需重新配对
💡 提示:SESSION_ID 相当于账号密码级别的凭据,请勿公开分享。
2. PREFIX:如何设置命令前缀
PREFIX=.
- 定义位置:config.js
- 默认值:
.(点号)
PREFIX 决定了你召唤机器人时按的「按钮」。设为 ! 就输入 !menu,设为 # 就输入 #alive。启动时机器人会用前缀构造匹配规则来识别每条消息是不是命令。
两个常用技巧:
- 设为
false:取消前缀,直接输入menu、sticker等也能触发命令(官方注释原话:Type false to use without prefix) - 前缀字符如果含
.*+?等正则特殊符号,机器人内部已自动转义,无需担心
3. MODE:私有模式还是公开模式
MODE=private
- 定义位置:config.js
- 可选值:
private(默认)/public
这是新手最关心的安全开关:
| 模式 | 谁能用命令 | 适用场景 |
|---|---|---|
private |
仅机器人账号所有者 + SUDO 名单 | 自用机器人,防滥用 ✅ |
public |
所有私聊/群成员 | 公开服务群、社区共享 Bot |
在 private 模式下,命令处理逻辑会先检查发送者是否为 owner 或 SUDO,不是就直接忽略——所以 MODE 和下面的 SUDO 是「组合拳」。
4. SUDO:管理员号码白名单
SUDO=919074692450, 918157993101
- 定义位置:config.js
- 格式:逗号分隔的纯数字号码(不含
+、@、空格分隔符随意)
启动时机器人会把 SUDO 按 , 或 ; 拆分,纯数字的号码会自动补上 .s.whatsapp.net 后缀变成 WhatsApp 内部 ID。SUDO 成员在 private 模式下拥有与 owner 相同的使用权限。
⚠️ 常见错误:填成
+91 90746...或91xxx@c.us都不会被识别——只填国家码+号码的纯数字。
5. BOT_INFO:机器人资料卡
BOT_INFO=ᴘʜᴏᴇɴɪx-ᴍᴅ;ᴀʙʜɪꜱʜᴇᴋ ꜱᴜʀᴇꜱʜ;919074692450;图片URL
- 定义位置:config.js
- 格式:
机器人名称;所有者名字;所有者号码;头像图片URL(分号分隔 4 段)
这段配置是机器人的「名片」,用于 alive 信息、菜单展示等。其中第 3 段的 owner 号码非常重要——START_MSG 首次连接通知、错误上报都会发给这个号码。
同类的还有两个「皮肤」配置:
- STICKER_DATA:表情包水印,格式
包名;作者 - ALIVE_DATA:alive 状态消息(支持
&sender、&platform等变量) - AUDIO_DATA:音乐转换的元数据
标题;艺术家;封面URL
6. TIMEZONE:时区设置
TIMEZONE=Asia/Kolkata
- 定义位置:config.js
- 默认值:
Asia/Kolkata(印度时间)
影响启动消息、日志时间戳等所有展示时间的地方。国内用户建议改为 Asia/Shanghai。
7. BOT_LANG:语言切换
BOT_LANG=EN
控制机器人回复消息所使用的语言。
8. START_MSG 与 ERROR_MSG:两个实用消息开关
START_MSG=true
ERROR_MSG=true
- 定义位置:config.js,均默认
true
| 开关 | 作用 | 建议 |
|---|---|---|
START_MSG |
每次成功连接后,自动向 owner 发送「已上线」通知(含当前 PREFIX、MODE) | 保持 true,方便确认重启成功 |
ERROR_MSG |
命令执行出错时,把错误详情私发给 owner | 排障神器,建议保持 true |
两个开关都通过 toBool 函数解析(config.js),填 true/on 为开,false 为关。
9. AUTO_* 系列:一键开启自动化功能
AUTO 配置区 是 Phoenix-MD 的「自动化开关面板」,全部默认 false,按需打开:
| 配置项 | 功能 | 默认 |
|---|---|---|
AUTO_ALWAYS_ONLINE |
保持「在线」状态(否则显示最后上线时间) | false |
AUTO_CALL_REJECT |
自动拒接来电并回复话术 | false |
AUTO_CALL_REJECT_MSG |
拒接来电的自定义回复 | 内置话术 |
AUTO_MSG_READ |
收到消息自动标记已读 | false |
AUTO_MSG_REACT |
收到消息自动发表情回应 | false |
AUTO_STATUS_SAVER |
自动保存联系人状态(朋友圈) | false |
AUTO_STATUS_VIEW |
自动查看联系人状态 | false |
AUTO_STATUS_REPLY / AUTO_STATUS_REACT |
自动回复/点踩状态(config.js) | false |
⚠️ 官方注释特别提到:过于激进的自动化(如批量群发、欢迎语轰炸)可能触发 WhatsApp 风控导致封号,开启前请三思。
10. DATABASE_URL:本地 SQLite 还是云端 Postgres
DATABASE_URL = process.env.DATABASE_URL || "./database.db"
这是 10 项中唯一「部署平台替你决定」的一项:
- 不设置:使用本地 SQLite 文件
./database.db,零配置开箱即用(适合 Termux、Docker 自建,参考 Dockerfile) - 设置 Postgres 连接串:自动切换为带 SSL 的 Postgres 连接(适合 Heroku 等平台,平台会自动注入)
机器人用它存储插件等数据,底层是 Sequelize ORM,插件数据模型见 lib/database/plugins.js。
速查表:10 个关键配置项一览
| # | 配置项 | 默认值 | 一句话说明 |
|---|---|---|---|
| 1 | SESSION_ID |
空(必填) | 登录凭据 |
| 2 | PREFIX |
. |
命令前缀,false 可免前缀 |
| 3 | MODE |
private |
private/public 控制使用范围 |
| 4 | SUDO |
作者号码 | 管理员号码白名单(纯数字) |
| 5 | BOT_INFO |
默认名片 | 名称;owner;号码;头像 |
| 6 | TIMEZONE |
Asia/Kolkata |
时区,国内改 Asia/Shanghai |
| 7 | BOT_LANG |
EN |
回复语言 |
| 8 | START_MSG / ERROR_MSG |
true |
上线通知 / 错误上报 |
| 9 | AUTO_* |
均 false |
自动化功能开关组 |
| 10 | DATABASE_URL |
./database.db |
不填=SQLite,填=Postgres |
常见问题 FAQ
Q1:改完配置没生效?
确认改的是机器人实际读取的位置:本地看 config.env,平台看环境变量面板;改完必须重启进程。
Q2:private 模式下别人@我机器人没反应?
正常现象。private 模式只响应 owner 与 SUDO 名单内的号码,把对方号码(纯数字)加入 SUDO 或改用 public 模式。
Q3:SUDO 填了自己的号还是不行?
检查格式:不要带 +、@、横杠,国家码紧跟号码,如 8613800000000。
Q4:可以免前缀同时保留 PREFIX 吗?
不行,二者互斥:PREFIX=false 后命令直接裸触发;想要「短前缀」可设成 !、/ 等单字符。
Q5:哪些配置绝对不能乱动?
config.js 底部标注了警告区:BASE_URL、BRANCH、DATABASE 连接逻辑请勿修改,它们与登录和存储流程强绑定。
掌握这 10 个配置项,你就完成了 Phoenix-MD 部署的 80%。建议先以默认的 private 模式 + PREFIX=. 跑通机器人,再按自己的群聊习惯逐项微调 🍀