Python telnetlib 詳解（含 3.13 之後的替代方案）

適用讀者：需要在受控內網/實驗環境使用 Telnet 的同學。生產環境強烈建議優先 SSH（如 Paramiko/Netmiko）。
版本事實：telnetlib 在 <span style="color:red">Python 3.11 標記棄用</span>，並已在 <span style="color:red">Python 3.13 移除</span>（PEP 594），3.12 仍可用；3.13+ 可用第三方兼容包或轉向更安全的庫。(Python Enhancement Proposals (PEPs), Python documentation)

一、核心認知（先讀後做）

• telnetlib 是標準庫的 Telnet 客户端實現，提供 Telnet 類與一組常量。3.11 起棄用，3.13 起不再內置。<span style="color:red">這意味着直接 import telnetlib 在 3.13 會報模塊不存在</span>。(Python documentation)

• 可選替代：

  • <span style="color:red">Netmiko</span>（基於 Paramiko，支持 Telnet/SSH，偏向網絡設備自動化）。(APNIC Blog, pyneng.readthedocs.io)
  • <span style="color:red">telnetlib3 / Exscript</span> 等第三方 Telnet 客户端庫。(Python documentation)
  • <span style="color:red">standard-telnetlib / telnetlib-313-and-up</span>：為 3.13+ 提供的“拷貝版”兼容包，便於平滑過渡。(PyPI)

二、快速上手（適用於 Python 3.12 或安裝兼容包後）

import telnetlib
import time

HOST = "192.0.2.10"      # 演示地址：請替換為你的 Telnet 目標
PORT = 23
USER = b"admin\n"
PASS = b"password\n"
CMD  = b"show status\n"
PROMPT = b"#"            # 設備提示符，需按實際調整

tn = telnetlib.Telnet(HOST, PORT, timeout=5)
tn.read_until(b"login: ", timeout=3)
tn.write(USER)
tn.read_until(b"Password: ", timeout=3)
tn.write(PASS)

tn.read_until(PROMPT, timeout=5)
tn.write(CMD)
output = tn.read_until(PROMPT, timeout=5)

tn.write(b"exit\n")
tn.close()

print(output.decode(errors="ignore"))

逐段解釋：

• import telnetlib：導入 Telnet 客户端實現；在 3.13+ 需先 pip install standard-telnetlib 或 telnetlib-313-and-up。<span style="color:red">否則會 ImportError</span>。(PyPI)
• HOST/PORT：遠端地址與端口，Telnet 默認 23。
• USER/PASS/CMD：以字節串發送，換行 \n 是很多設備登錄與命令的必要結束符。
• PROMPT：設備提示符（如 >, #, $），用於界定輸出讀取的結束位置。
• Telnet(HOST, PORT, timeout=5)：建立 TCP 連接並設置超時，避免掛死。
• read_until(...)：阻塞讀取直到匹配的字節序列或超時，典型用法是等待 login:、Password:、最終提示符。
• write(...)：發送登錄名/口令/命令；注意儘量使用字節串並追加換行。
• output = read_until(PROMPT, timeout=5)：讀取命令回顯到提示符，得到完整輸出。
• close()：釋放連接；Telnet為明文協議，<span style="color:red">敏感環境不建議使用</span>。

三、常見坑與排查 🧰

• <span style="color:red">讀取阻塞</span>：read_until 不返回，多為提示符不匹配或命令未追加換行；請抓包/觀察回顯校準 PROMPT。
• <span style="color:red">中文亂碼</span>：遠端編碼與本地不一致，decode(errors="ignore") 可兜底，最好明確編碼（如 gbk/utf-8）。
• <span style="color:red">3.13+ 導入失敗</span>：安裝兼容包或改用 Netmiko。(PyPI)
• <span style="color:red">安全</span>：Telnet 明文傳輸帳號口令，優先 SSH（Paramiko/Netmiko），只在內網/實驗網段使用。(APNIC Blog)

四、替代實現：Netmiko（支持 Telnet/SSH，更安全易用）

from netmiko import ConnectHandler

device = {
    "device_type": "cisco_ios_telnet",  # 換為你的設備類型；若用 SSH 改為 cisco_ios
    "host": "192.0.2.10",
    "username": "admin",
    "password": "password",
    "port": 23,
    "timeout": 5,
}

with ConnectHandler(**device) as conn:
    output = conn.send_command("show status")
    print(output)

逐段解釋：

• ConnectHandler：根據 device_type 自動處理登錄、提示符、分頁等細節，減少手寫 read_until 的繁瑣。
• device_type：選擇合適廠商與協議（*\_telnet 或 *\_ssh）；切換到 SSH 僅需改類型與端口即可提升安全性。
• send_command：發送命令並返回淨化後的輸出；複雜場景可用 send_config_set 等。(pyneng.readthedocs.io)

五、工作流程（思維導圖/流程圖）

flowchart LR
A[建立TCP連接] --> B[等待login提示]
B --> C[發送用户名]
C --> D[等待Password提示]
D --> E[發送口令]
E --> F[等待提示符]
F --> G[發送命令]
G --> H[read_until提示符收集輸出]
H --> I[業務解析/打印]
I --> J[退出並關閉連接]

六、對比與選型建議

（telnetlib 移除與替代説明來源：官方文檔與 PEP 594；Netmiko/Paramiko 使用建議參考社區與文檔綜述。）(Python documentation, Python Enhancement Proposals (PEPs), APNIC Blog)

七、穩定性與可維護性建議 ✅

• 版本控制：在 <span style="color:red">Python 3.12 或更低</span>使用 telnetlib，同時預備向 Netmiko/SSH 遷移的腳本。(Python documentation)
• 3.13+ 代碼：短期可引入 <span style="color:red">standard-telnetlib / telnetlib-313-and-up</span>，中長期 <span style="color:red">統一切換 SSH</span>。(PyPI)
• 安全加固：若必須 Telnet，請限制到內網、啓用訪問控制與賬號最小化權限，並記錄審計。🙂

附：簡單交互封裝（便於複用）

import telnetlib

class TelnetClient:
    def __init__(self, host, port=23, timeout=5, prompt=b"#"):
        self.host, self.port, self.timeout, self.prompt = host, port, timeout, prompt
        self.tn = None

    def login(self, user: bytes, passwd: bytes):
        self.tn = telnetlib.Telnet(self.host, self.port, self.timeout)
        self.tn.read_until(b"login: ", self.timeout); self.tn.write(user + b"\n")
        self.tn.read_until(b"Password: ", self.timeout); self.tn.write(passwd + b"\n")
        self.tn.read_until(self.prompt, self.timeout)

    def run(self, cmd: bytes) -> str:
        self.tn.write(cmd + b"\n")
        data = self.tn.read_until(self.prompt, self.timeout)
        return data.decode(errors="ignore")

    def close(self):
        try: self.tn.write(b"exit\n")
        except Exception: pass
        finally: self.tn.close()

逐段解釋：

• TelnetClient.__init__：接收主機、端口、超時與提示符，便於不同設備複用。
• login：順序等待 login: 與 Password:，每步都設置超時，防卡死；最終等待提示符確認登錄成功。
• run：發送命令並等待提示符截斷輸出，返回字符串。
• close：儘量發送 exit 再關閉，異常時也保證釋放 socket。

温馨提示：如你的環境已升級到 3.13，請先安裝兼容包或切換 Netmiko/SSH，再運行以上示例。(PyPI)

一句話總結：telnetlib 已在 <span style="color:red">Python 3.13 移除</span>；如必須 Telnet，可短期用兼容包，長期應以 <span style="color:red">SSH（Netmiko/Paramiko）</span> 為主，既穩又安全。(Python documentation, Python Enhancement Proposals (PEPs), APNIC Blog)