Debian上TigerVNC端口如何配置

Debian 上 TigerVNC 端口配置

端口规则与快速选择

• TigerVNC 的显示编号与端口遵循规则：端口 = 5900 + 显示编号。例如：显示编号 :1 → 5901、:2 → 5902。因此，选择端口本质上就是选择显示编号，或直接指定绝对端口。为降低冲突与扫描风险，建议使用 1024–65535 范围内的端口，并确保未被占用。

方式一 命令行临时指定端口

• 安装与密码
  • 安装：sudo apt update && sudo apt install tigervnc-standalone-server tigervnc-common
  • 设置 VNC 密码：vncpasswd
• 启动并指定端口
  • 指定显示编号（推荐）：vncserver :1 -geometry 1280x800（将使用 5901/tcp）
  • 指定绝对端口：例如 vncserver :1 -rfbport 5902（仍对应 :1，但监听 5902/tcp）
• 常用管理
  • 查看已启动会话：vncserver -list
  • 停止会话：vncserver -kill :1
• 说明
  • 若未显式指定 -rfbport，将按 5900 + 显示编号 自动分配端口。

方式二 使用 systemd 服务固定端口

• 准备服务单元
  • 复制示例：sudo cp /lib/systemd/system/vncserver@.service /etc/systemd/system/tigervncserver@.service
• 编辑单元文件
  • 在 [Service] 的 ExecStart 中加入所需参数，例如：
    • 固定显示编号（端口 5901）：ExecStart=/usr/bin/vncserver -geometry 1280x800 :%i
    • 固定绝对端口（例如 5902）：ExecStart=/usr/bin/vncserver -geometry 1280x800 -rfbport 5902 :%i
• 使配置生效并启动
  • 重载 systemd：sudo systemctl daemon-reload
  • 启动服务：sudo systemctl start tigervncserver@:1.service
  • 开机自启：sudo systemctl enable tigervncserver@:1.service
• 说明
  • 使用 systemd 可确保端口与实例在重启后保持一致，便于运维与审计。

防火墙与连接方式

• 防火墙放行
  • UFW：sudo ufw allow 5901/tcp（如改用 5902，则放行 5902/tcp）
• 客户端连接
  • 地址格式：<服务器IP>:<端口或显示编号>，例如 192.0.2.10:5901 或 192.0.2.10:1
• 安全建议
  • 默认监听仅本地时，可通过 SSH 端口转发安全接入：vncviewer -via user@server localhost:1
  • 若需直接对外开放，可在服务启动参数中加入 -localhost no，并仅对可信网段放行防火墙。

常见问题排查

• 端口占用
  • 检查端口：ss -lntp | grep 5901 或 lsof -iTCP:5901 -sTCP:LISTEN
  • 解决：更换显示编号/端口，或停止占用该端口的进程后再启动 VNC
• 服务未启动或配置未生效
  • 查看状态：systemctl status tigervncserver@:1.service
  • 查看日志：journalctl -u tigervncserver@:1.service -b
  • 变更服务单元后执行：sudo systemctl daemon-reload
• 仅本地可连
  • 启动时未加 -localhost no 会默认仅监听 127.0.0.1；使用 SSH 转发或显式添加 -localhost no 并放行防火墙。