telnetlib 是 Python 的标准库之一，它提供了一个 Telnet 类，用于实现 Telnet 客户端的功能，Telnet 是一种古老的网络协议，主要用于远程登录和管理网络设备，如路由器、交换机、防火墙等。

重要提示： 由于 Telnet 协议以明文形式传输所有数据（包括用户名和密码），它被认为是不安全的，在现代应用中，强烈推荐使用更安全的协议，如 SSH（可以使用 paramiko 或 fabric 库）来替代 Telnet，但在需要与遗留设备或特定系统交互时，telnetlib 仍然是一个有用的工具。

核心类：telnetlib.Telnet

这是 telnetlib 模块中唯一需要使用的类，通过实例化这个类，你可以创建一个到 Telnet 服务器的连接。

基本用法和工作流程

一个典型的 Telnet 交互流程如下：

1. 连接：创建 Telnet 对象并连接到服务器。
2. 登录：发送用户名和密码,并读取服务器的响应。
3. 交互：发送命令并读取命令的输出。
4. 关闭：完成操作后,关闭连接。

主要函数和方法详解

__init__(host, port=23, timeout=10)

• 功能：构造函数，用于创建一个新的 Telnet 对象并尝试连接到指定的主机。

  
  （图片来源网络，侵删）

• 参数：

  • host (str): 要连接的主机名或 IP 地址。
  • port (int, 可选): 要连接的端口号，Telnet 默认端口是 23。
  • timeout (int, 可选): 连接超时时间（秒），如果超时，会抛出 socket.timeout 异常。

• 返回值：一个 Telnet 对象实例。

• 示例：

  import telnetlib
  try:
      # 连接到本地 Telnet 服务器 (默认端口 23)
      tn = telnetlib.Telnet('localhost', timeout=5)
      print("连接成功！")
  except ConnectionRefusedError:
      print("连接被拒绝，请确保 Telnet 服务器正在运行。")
  except Exception as e:
      print(f"发生错误: {e}")

read_until(expected, timeout=None)

• 功能：从套接字读取数据，直到读取到 expected 指定的字节串或超时。
• 参数：
  • expected (bytes): 期望读取到的内容,作为停止读取的标志。
  • timeout (float, 可选): 超时时间（秒），如果超时,返回已读取的所有数据。
• 返回值：读取到的字节串 (bytes)。
• 示例：

  # 假设已经连接 tn
  # 等待直到看到 "login:" 提示符
  login_prompt = tn.read_until(b"login: ", timeout=10)
  print(f"收到登录提示: {login_prompt.decode('ascii')}")

read_all()

• 功能：读取套接字中所有可用的数据。
• 参数：无。
• 返回值：读取到的所有字节串 (bytes)。
• 注意：如果服务器持续不断发送数据，这个函数可能会阻塞，通常最好在发送命令后使用 read_until() 来等待特定的提示符。

write(buffer)

• 功能：向套接字写入数据。
• 参数：
  • buffer (bytes 或 str): 要写入的数据，如果是字符串，它会被编码为 ASCII 字节串。
• 返回值：写入的字节数。
• 示例：

  # 发送用户名
  username = "myuser"
  tn.write(username.encode('ascii') + b"\n")  # Telnet 命令通常需要以换行符结尾

expect(list_of_patterns, timeout=None)

• 功能：这是一个非常强大的方法，它比 read_until 更灵活，它会读取数据，直到匹配到 list_of_patterns 中的任何一个模式。

  
  （图片来源网络，侵删）

• 参数：

  • list_of_patterns (list): 一个包含模式的列表，模式可以是字节串 (bytes) 或编译好的正则表达式对象 (re.compile(rb'pattern'))。
  • timeout (float, 可选): 超时时间（秒）。

• 返回值：一个元组 (index, match, bytes_read)。

  • index: 匹配到的模式在列表中的索引。
  • match: 如果模式是正则表达式，这是一个匹配对象；否则为 None。
  • bytes_read: 实际读取到的字节串。

• 示例：

  import re
  # 等待 "login:" 或 "Username:" 出现
  # 注意：模式必须是 bytes 类型
  patterns = [b"login: ", b"Username: "]
  (index, match, output) = tn.expect(patterns, timeout=10)
  if index == 0:
      print("匹配到了 'login: '")
  elif index == 1:
      print("匹配到了 'Username: '")

interact()

• 功能：将控制权交给用户，让你可以在 Python 脚本和 Telnet 服务器之间进行手动交互,这对于调试非常有用。
• 参数：无。
• 返回值：无。
• 如何退出：在交互模式下，输入 Ctrl+]，然后输入 quit 并回车。

close()

• 功能：关闭 Telnet 连接。
• 参数：无。
• 返回值：无。
• 示例：

  tn.close()
  print("连接已关闭。")

完整示例：自动化登录并执行命令

下面是一个完整的脚示例，演示如何使用 telnetlib 登录到一个设备，执行几个命令,并打印输出。

假设目标设备：

• IP: 168.1.1
• 用户名: admin
• 密码: password
• 提示符为

import telnetlib
import time
# --- 配置 ---
HOST = "192.168.1.1"
USER = "admin"
PASSWORD = "password"
PROMPT = b"# "  # 注意：提示符是字节串，并且后面通常有空格
def telnet_connect_and_execute():
    try:
        # 1. 连接到设备
        print(f"正在连接到 {HOST}...")
        tn = telnetlib.Telnet(HOST, timeout=15)
        # 2. 登录流程
        # 等待 "Login:" 或 "Username:" 提示
        tn.read_until(b"login: ", timeout=5)
        tn.write(USER.encode('ascii') + b"\n")
        # 等待 "Password:" 提示
        tn.read_until(b"Password: ", timeout=5)
        tn.write(PASSWORD.encode('ascii') + b"\n")
        # 等待登录成功，出现命令提示符
        # 有时登录后会有欢迎信息，所以最好用 expect 或 read_until 等待提示符
        tn.expect([PROMPT], timeout=5)
        print("登录成功！")
        # 3. 执行命令
        commands = [
            "show version",
            "show interfaces brief",
            "exit"
        ]
        for cmd in commands:
            print(f"\n--- 正在执行命令: {cmd} ---")
            tn.write(cmd.encode('ascii') + b"\n")
            # 等待命令执行完成并返回提示符
            # read_until 会读取从命令结束到下一个提示符之间的所有内容
            output = tn.read_until(PROMPT, timeout=10)
            # 去掉命令本身和最后的提示符，只保留输出内容
            # 注意：这种处理方式可能不适用于所有设备，需要根据实际情况调整
            output_lines = output.decode('ascii').splitlines()
            # 假设输出至少有三行：命令行、空行、结果、提示符
            if len(output_lines) > 2:
                print("\n".join(output_lines[1:-1]))
            else:
                print("未获取到有效输出或输出格式不符预期。")
            time.sleep(1) # 给设备一点处理时间
    except ConnectionRefusedError:
        print(f"错误：无法连接到 {HOST}，请检查IP地址和Telnet服务是否开启。")
    except socket.timeout:
        print("错误：连接或读取操作超时。")
    except EOFError:
        print("错误：连接被对方意外关闭。")
    except Exception as e:
        print(f"发生未知错误: {e}")
    finally:
        # 4. 确保连接被关闭
        if 'tn' in locals() and tn:
            tn.close()
            print("\n连接已关闭。")
if __name__ == "__main__":
    telnet_connect_and_execute()

telnetlib 的局限性

1. 安全性：最大的问题，所有数据（包括密码）都是明文传输。
2. 功能简单：它是一个基础的客户端，不支持 Telnet 的所有高级选项或协商。
3. 解析困难：从输出中提取信息需要仔细处理，因为不同设备的输出格式差异很大,你需要编写健壮的字符串或正则表达式匹配逻辑。
4. 阻塞式：像 read_until 这样的方法是阻塞的，如果服务器不发送预期的数据,脚本会一直等待。

更现代的替代方案：SSH

对于任何新的项目，都应该使用 SSH，Python 中有优秀的第三方库来支持 SSH，其中最著名的是 paramiko。

使用 paramiko 的简单示例：

# 首先安装 paramiko
pip install paramiko

import paramiko
import time
HOST = "192.168.1.1"
USER = "admin"
PASSWORD = "password"
ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy()) # 自动添加主机密钥（不安全，仅用于测试）
try:
    print("正在通过 SSH 连接...")
    ssh.connect(HOST, username=USER, password=PASSWORD, timeout=10)
    print("SSH 连接成功！")
    commands = ["show version", "show interfaces brief"]
    for cmd in commands:
        print(f"\n--- 正在执行命令: {cmd} ---")
        stdin, stdout, stderr = ssh.exec_command(cmd)
        # 读取输出
        output = stdout.read().decode('ascii')
        error = stderr.read().decode('ascii')
        if error:
            print(f"错误输出:\n{error}")
        print(f"命令输出:\n{output}")
        time.sleep(1)
except Exception as e:
    print(f"SSH 错误: {e}")
finally:
    ssh.close()
    print("\nSSH 连接已关闭。")

希望这份详细的讲解对你有帮助！