Yealink T1x–T5x 和 CP9xx — 为我们的 PBX 进行设置
Yealink 是桌面 SIP 电话最常见的品牌：场所里最常放在前台的是简单的 T30/T31/T33，管理员处是带快速拨号键的 T4x，办公室里是触屏的 T5x；会议室则用会议电话 CP9xx。这些型号都有同一个网页界面和相同的字段名称，所以设置步骤只有一套：区别只在于话机本身上的菜单项（黑白屏和彩色屏上的叫法不同——文中已注明）。
所有品牌都相同的部分——凭据、端口、网络以及何时需要重置——在《SIP 电话设置》概览中说明。这里只讲 Yealink 上需要按的内容。
需要准备什么#
- 来自管理后台的分机凭据：窗口**“分机凭据”**（电话 → “员工和群组” → 对操作员点“重置密码”，或在创建时直接获取）——SIP 服务器、内部分机号、登录名、密码、端口、传输方式。详见概览。
- 用网线接入场所内部网络（不是访客 Wi-Fi）并已开机的话机：供电为来自交换机的 PoE 或 Yealink 5 V 电源适配器（名称中不带字母 P 的型号只能用电源适配器）。
- 在同一网络中的电脑或笔记本，装有任意浏览器。
也可以直接在话机上设置（Menu → Advanced → Accounts），但用按键输入长登录名和密码很不方便——下面走浏览器路径，话机上的路径放在折叠块中。
第 1 步：查看电话的 IP 地址#
等电话启动完成（屏幕上显示“Welcome / Initializing… please wait”，然后是时钟），在待机状态下按 OK 键——导航区中央的圆形按钮。屏幕上会显示电话的 IP 地址（IPv4 行），以及 MAC 地址和固件版本。同一屏幕也可通过 Menu → Status 打开。
插图：Yealink T3 Series IP Phones User Guide V86.5，第 12 页（“Hardware”）。
截图：Yealink T3 Series IP Phones User Guide V86.5，第 15 页（“Idle Screen”）。
如果屏幕上显示的是 0.0.0.0 或“Network unavailable”而不是地址——说明电话没有从路由器获取到地址：检查网线（接电话上的 Internet 端口，不是 PC 端口），以及网络中是否开启了 DHCP。
第 2 步：登录网页界面#
在电脑上打开浏览器，在地址栏输入电话的 IP——例如 http://192.168.0.10。如果浏览器提示证书问题（电话以 https 打开），点击“继续”——这是话机自身的自签名证书。
| 出厂值 | |
|---|---|
| 地址 | http://<电话 IP> |
| 登录名 | admin |
| 密码 | admin |
截图：Yealink SIP-T46U Quick Start Guide V86.36，第 3 页（“Configuring via web user interface”）。
还有第二个权限受限的用户 user/user——通过它无法配置账户，请以 admin 登录。
在出厂密码未更改前，电话会在状态栏显示警告图标，网页界面则显示“Default password is in use”提示条。设置完成后应立即更改密码：在浏览器中 Security → Password，或在话机上 Menu → Settings → Advanced Settings → Set Password。如果密码曾经改过且已丢失——无法恢复，只能重置为出厂设置。
第 3 步. 输入 PBX 账户凭据#
在网页界面中打开 Account 选项卡，在左侧选择 Register，在顶部的 Account 列表中选择 Account 1（T30/T31 只有一条线路，其他型号有多条；请使用第一条）。将 Line Active 切换为 Enabled，并填写“分机账户凭据”窗口中的字段：
| 管理后台（“分机账户凭据”） | 电话（Account → Register） |
|---|---|
| SIP 服务器 | SIP Server 1 → Server Host |
端口 5060 |
SIP Server 1 → Port（出厂值本来就是 5060） |
传输协议 UDP |
SIP Server 1 → Transport → UDP（出厂值） |
| 登录名 | Register Name 和 User Name — 两个字段都填同一个长字符串 sip-…-<号码> |
| 密码 | Password |
| 分机号码 | Label — 屏幕上显示的线路标签（可以写号码或“酒吧”） |
| — | Display Name — 来电时同事看到的名称 |
截图：Yealink SIP-T46U Quick Start Guide V86.36，第 3 页（“Account Settings”）。
点击页面底部的 Confirm。无需重启——电话会在几秒内完成注册。
附加：编解码器、DTMF、NAT、时间和语言
这些都不是注册所必需的——出厂值即可。如果电话拿到时带有他人的设置，才需要检查：
- 编解码器 — Account → Codec → Audio Codec：已启用的列表中应包含 PCMA (G.711 A-law)、PCMU (G.711 µ-law) 和 G722；其余（G729、iLBC、Opus）可以保留或关闭——PBX 不使用它们。
- DTMF — Account → Advanced → DTMF Type：RFC2833（出厂值）。用于让语音菜单和通话期间的按键指令传达到 PBX。
- NAT / keep-alive — Account → Advanced → Keep Alive Type：Default。无需启用 STUN（Network → NAT）。
- 时间 — Settings → Time & Date：门店所在时区；NTP 默认从 DHCP 或 Yealink 服务器获取。时间不正确时，话机上的通话记录会显示“过去的时间”。
- 界面语言 — Settings → Preference → Language（网页）和 Menu → Settings → Basic Settings → Language（话机）。
直接在话机上设置，无需浏览器
- 黑白屏幕（T19、T21、T23、T27、T30、T31、T40、T41、T42）：Menu → Settings → Advanced Settings（密码
admin）→ Accounts → Account 1 → Active Line: Enabled，然后填写 Label、Display Name、Register Name、User Name、Password、SIP Server 1 和 Port。 - 彩色屏幕（T33、T34W、T43U、T46、T48、T53、T54W、T57W、T58W）：Menu → Advanced（密码
admin）→ Accounts → Account 1 → Activation: Enabled，字段相同。 - 会议电话 CP925/CP965：More → Advanced（密码
admin）→ Accounts。
字母通过数字键盘按键输入，如同老式手机；大小写切换是屏幕按键 abc/ABC/2aB。登录名中的连字符在 * 键上，或通过带符号的屏幕按键输入。
第 4 步. 检查注册#
- 在电话上。 黑白屏 T3x 在左上角线路标签旁会出现听筒图标：绿色 — Registered（一切正常），灰色 — Register Failed（服务器拒绝：请检查登录名和密码），黄色 — Registering（等待服务器响应：网络、地址、端口）。彩色型号在屏幕左侧的线路按键上显示相同内容。状态栏中的 “!” 图标 — 打开 Menu → Status → Warnings：那里有问题的文字说明（包括“Default password is in use”——这不是注册错误）。
- 在管理后台。 电话 → “员工和群组”：坐席旁会亮起绿点，旁边是最后活动时间和电话自报的型号字符串（例如
Yealink SIP-T31G 124.86.0.130）。状态更新频率不超过每分钟一次。 - 通话。 拨打同事的分机号码。如果通话接通但一方听不到——这不是注册问题，而是语音流问题：请关闭路由器上的 SIP ALG（参见概览）。
音质——回声测试 *43。 绿点只说明注册成功：语音走单独的流，也会单独出问题。用电话拨打 *43 并按 Send / OK（大多数话机不会仅凭星号开始拨号）。PBX 会接听，一秒后给出短促的提示音，然后会把您的声音回传给您——对着话筒说十秒钟左右并听自己。能听到提示音和自己——声音双向正常。有提示音但听不到自己——声音没有从电话传到 PBX（最常见的原因是路由器上的 SIP ALG）。连提示音都没有——声音没有从 PBX 传到电话。所有情况的排查和实测数据（丢包、抖动、延迟）见“通话质量检查”章节。
恢复出厂设置#
恢复会清除账户、网络设置（静态 IP、VLAN）、语言、通讯录和通话记录；固件保留。如果电话拿到手时带有他人的设置（尤其是他人自动配置服务器的地址——这种设备会在每次重启后覆盖你的账户），如果管理员密码丢失，或者经过各种尝试后电话行为异常，就需要恢复出厂设置。
在话机上操作（如果知道管理员密码）：
- Menu → Settings → Advanced Settings（密码
admin）→ Reset Config。在 T33P/T33G 及其他彩色型号上：Menu → Advanced（密码admin）→ Reset Config。 - 选择 Reset to Factory Settings → Reset，用 OK 确认。
- 电话会重启；恢复需要几分钟——在出现待机屏幕之前不要断开电源。
在话机上操作（如果不知道密码）： 在待机状态下按住 OK 键约 10 秒，直到电话询问“Reset to factory setting?”，然后用 OK 确认。此功能出厂时已启用；如果管理员将其关闭（参数 features.reset_by_long_press_enable = 0），电话将没有反应或询问密码——那就只能走需要密码的路径。
从浏览器操作： Settings → Upgrade → Reset to Factory → 在“Do you want to reset to factory?”的提示下点击 OK。旁边还有 Reset Local Settings——这不是完整恢复，而只是清除手动修改。
恢复后：语言（Menu → Settings → Basic Settings → Language）、时区，必要时设置网络——然后重新执行第 3 步，使用管理后台中的凭据。网页界面密码将重新变为 admin。
仅重启电话而不恢复出厂设置：Menu → Settings → Basic Settings → Reboot（彩色型号上为 Menu → Basic → Reboot），或在待机状态下长按 ✕ (Cancel) 键。
如果电话无法注册#
按顺序排查，从常见到少见：
- 灰色图标 / Register Failed——服务器拒绝。10 次中有 9 次是登录名没有完整输入：Register Name 和 User Name 中应填写
sip-…-<号码>字符串，而不是“101”。第二个可能原因是密码：如果有人在管理后台点击过“重置密码”，旧密码已失效；不要尝试猜测，请重新发放一个新密码并重新输入。 - 黄色图标 / Registering 一直不通过——请求无法到达服务器。检查 Server Host（窗口中的地址，不带
http://，不带空格）、Port 5060、Transport UDP。拥有独立 PBX 主机的场所地址是自己的，而不是通用的sip.<域名>。 - Line Active: Disabled——线路被关闭了。启用并点击 Confirm。
- 电话获取了 IP，但无法访问互联网——路由器上关闭了出站 UDP 5060 或启用了 SIP ALG；电话处于访客 Wi-Fi/VLAN 中。请用网线连接到内部网络。
- 重启后设置“自己变了”——电话从上一任所有者的自动配置服务器拉取了他人配置：Settings → Auto Provision → 清空 Server URL，关闭 PNP Active 和 DHCP Active——或者执行恢复出厂设置。
- 固件不是 SIP 版。 Yealink 会为 Microsoft Teams / Skype for Business / Zoom 发布相同型号的固件版本（例如 T55A、T56A、T58A、MP 系列）：启动屏幕上会显示 Teams/Zoom 标志，网页界面中完全没有 Account 选项卡。这种设备无法连接到普通 PBX，除非从 Yealink 官网刷入 SIP 固件（并非所有型号都有该固件）。
如果仍未解决——或者电话已注册但没有声音、通话 30 秒后中断、收不到来电：按症状排查——“电话不工作：诊断”，提示信息和错误代码解读——“无法注册：错误代码”。
型号系列#
所有型号的网页界面和账户字段都相同；区别在于屏幕、线路数量和供电。型号中的字母 P = 支持 PoE，G = 千兆端口（以及 PoE），U/W = 新一代（所有型号均支持 PoE）。
型号表
| 型号 | 屏幕 / 线路 | PoE | 配置特点 |
|---|---|---|---|
| SIP-T19 E2 / T19P E2 | 黑白，1 线路 | 仅 P | “黑白”类型菜单 |
| SIP-T21 E2 / T21P E2 | 黑白，2 线路 | 仅 P | — |
| SIP-T23G | 黑白，3 线路 | 是 | — |
| SIP-T27G | 黑白，6 线路 | 是 | — |
| SIP-T30 / T30P | 黑白，1 线路 | 仅 P | Menu → Settings → Advanced Settings |
| SIP-T31 / T31P / T31G | 黑白，2 线路 | 仅 P 和 G | — |
| SIP-T33P / T33G | 彩色，4 线路 | 是 | 菜单项更短：Menu → Advanced，Menu → Basic |
| SIP-T34W | 彩色，4 线路，Wi-Fi | 是 | 可通过 Wi-Fi 配置网络（Menu → Advanced → Network → Wi-Fi） |
| SIP-T40G / T41S / T42S | 黑白，3–12 线路 | 是 | 已停产，固件 V84–V85 — 字段相同 |
| SIP-T43U / T46U / T48U | 黑白 3.7" / 彩色 4.3" / 触屏 7"；12–16 线路 | 是 | 线路 — 通过左侧按键或屏幕上操作 |
| SIP-T46S / T48S | 彩色 / 触屏，16 线路 | 是 | T4U 的上一代 |
| SIP-T53 / T53W / T54W | 黑白 / 彩色，12–16 线路；W — Wi-Fi 和 Bluetooth | 是 | — |
| SIP-T57W / T58W | 触屏 7"，16 线路；T58W — 带摄像头 | 是 | — |
| CP920 / CP925 / CP965 | 会议电话，触屏 | 是（CP965 — PoE+） | 在设备上：More → Advanced → Accounts |
未经重新刷机不适用：带 A 后缀的型号和 MP 系列（T55A、T56A、T58A、MP52/MP54/MP56）— 这些是运行 Android 的 Teams/Zoom 电话。
批量自动配置（provisioning）
Yealink 可以从 TFTP/HTTP/HTTPS 服务器获取配置：先取通用文件 y000000000000.cfg（按型号，例如 y000000000123.cfg），然后取个人文件 <MAC>.cfg。电话通过 DHCP option 66（或 43）或从 Settings → Auto Provision → Server URL 获取服务器地址。在网页界面中的手动修改会保存在电话本机的 <MAC>-local.cfg 文件中。
文件中的账户参数：
account.1.enable = 1
account.1.label = 酒吧
account.1.display_name = 酒吧
account.1.user_name = sip-xxxxxxxx-101
account.1.auth_name = sip-xxxxxxxx-101
account.1.password = <管理后台中的密码>
account.1.sip_server.1.address = <管理后台中的 SIP 服务器>
account.1.sip_server.1.port = 5060
account.1.sip_server.1.transport_type = 0
我们的平台不提供自动配置服务器 — 这是为拥有自己配置服务器的用户提供的方案（详见 Yealink Auto Provisioning Guide，参见“来源”）。
常见问题#
电话显示灰色听筒图标和“Register Failed” — 怎么办？#
服务器拒绝了注册：登录名或密码错误。打开 Account → Register，核对 Register Name 和 User Name 中是否填写了完整登录名（sip-…-<号码>），密码是否为最近一次下发的密码。如有疑问 — 在管理后台点击“重置密码”并输入新密码。
在哪里查看电话连接的是哪个服务器？#
Menu → Status → More → Accounts（彩色屏幕上为 Menu → Status → Accounts）：显示账户及其状态。服务器地址的完整内容只能在网页界面的 Account → Register 页面看到。
可以用管理后台的 Yealink QR 码进行配置吗？#
不可以。只有 Zoiper 和 Linphone 软电话能识别“分机凭据”窗口中的 QR 码。桌面 Yealink 通过网页界面中的字段进行配置；“复制所有设置”按钮会以一段文本形式提供这些设置 — 方便随时查看。
电话之前属于其他运营商，配置后第二天早上又无法注册#
电话内部残留了前运营商的自动配置服务器地址：每次重启时电话都会下载他人的配置。请执行恢复出厂设置并重新配置 — 或清除 Settings → Auto Provision → Server URL。
员工的内部号码变更了 — 电话中需要改什么？#
登录名包含号码，因此新号码就是新账户：在 Account → Register 中重新填写新“分机凭据”窗口中的 Register Name、User Name 和 Password。Label 也应更新，以便屏幕上显示当前号码。
一部电话可以绑定两个分机吗？#
可以，在具有两条及以上线路的型号上：Account → Register → 选择 Account 2 并填写第二个账户。T19/T30 只有一条线路。
来源#
- Yealink SIP-T46U Quick Start Guide V86.36（“Configuring Your Phone”章节：按 OK 键查看 IP，使用 admin/admin 登录，Account → Register）— https://support-cdn.yealink.com/attachment/document/20211224/dfc97b13-40d3-4808-a9e7-c602489b5fa3.pdf?v=1640312625109
- Yealink T3 Series IP Phones User Guide V86.5（T30/T31/T33：屏幕、按键、Menu → Status → Warnings、Reboot、Resetting to Factory Settings — 第 84–85 页，管理员密码 — 第 74 页）— https://support-cdn.yealink.com/attachment/upload/attachment/2021-3-25/3/4d4437e3-1912-4e11-9bce-d9ed0dd68a0a/Yealink+T3+Series+IP+Phones+User+Guide+V86.5.pdf
- Administrator's Guide for SIP-T2/T3/T4/T5/CP920 IP Phones V86.60（出厂登录名 admin/admin 和 user/user — 第 83 页；Line Active 和菜单路径 — 第 328–332 页；SIP Server → Port/Transport；Reset to Factory 和长按 OK 重置 — 第 608 页；Viewing Device Status — 第 616 页）。Yealink 不提供最新版本的直接链接（文档门户基于 JavaScript），副本 — https://data.nag.wiki/Yealink/SIP-T53W/Yealink%20SIP-T2%20Series%20T3%20Series%20T4%20Series%20T5%20Series%20CP920%20IP%20Phones%20Administrator%20Guide%20V86.60%20(4).pdf ；官方门户 — https://support.yealink.com/en/portal/docList?archiveType=document&productCode=809bb158e075168e
- Yealink SIP IP Phones Auto Provisioning Guide V81.73（文件 y000000000000.cfg / MAC.cfg，DHCP 66）— https://support.yealink.com/forward2filesystem/attachment/upload/attachment/2017-9-20/3/69be1ab8-91d3-46d7-b6f8-e2c7abe35272/Yealink+SIP+IP+Phones+Auto+Provisioning+Guide_V81_73.pdf
- 目录原始来源登记表：
docs/phone-knowledge/sources/yealink.json