Phoenix-MD配置手册:PREFIX、MODE、SUDO等10个关键配置项深度解析

原创2026-11-02 15:35:271,373 阅读

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
开关 作用 建议
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=. 跑通机器人,再按自己的群聊习惯逐项微调 🍀

登录后查看全文
Phoenix-MD-Bot