如何在Ubuntu上配置TigerVNC的分辨率

Ubuntu 上配置 TigerVNC 分辨率的实用方法

一 命令行临时指定分辨率

• 安装并初始化密码后，启动会话时直接用 -geometry 指定，例如：
  • 启动一个会话并设置分辨率为 1920×1080：vncserver :1 -geometry 1920x1080
  • 指定色彩深度（可选）：vncserver :1 -geometry 1920x1080 -depth 24
  • 允许远程主机连接（可选）：vncserver :1 -geometry 1920x1080 -localhost no
• 显示编号 :1 对应端口 5901（规则为 5900 + 显示编号）。
• 修改已存在会话的分辨率需先结束再启动：vncserver -kill :1 后重新执行带 -geometry 的命令。

二 持久化配置分辨率

• 方法 A 使用用户配置文件 ~/.vnc/config
  • 写入参数：echo "geometry=1920x1080" >> ~/.vnc/config
  • 重启会话：vncserver -kill :1 && vncserver :1
• 方法 B 使用 systemd 服务文件（推荐用于开机自启）
  • 创建或编辑：sudo nano /etc/systemd/system/vncserver@.service
  • 在 [Service] 的 ExecStart 中加入 -geometry，例如：
    • Ubuntu 22.04 示例：ExecStart=/usr/bin/vncserver -depth 32 -geometry 1920x1080 -localhost :%i
    • Ubuntu 20.04 示例：ExecStart=/usr/bin/vncserver -depth 24 -geometry 1280x800 -localhost :%i
  • 重新加载并启用：
    • sudo systemctl daemon-reload
    • sudo systemctl enable --now vncserver@1.service
• 说明：systemd 方式适合长期运行与多用户环境，且便于统一管理端口、分辨率与自启。

三 运行时动态修改分辨率

• 进入 VNC 会话后，使用 xrandr 调整。先查看显示名称：
  • xrandr 输出中找到类似 VNC-0 的虚拟输出
• 设置新分辨率（示例为 1920×1080）：
  • xrandr --output VNC-0 --mode 1920x1080
  • 若需新增自定义模式，可先生成 modeline 再添加模式，然后设为首选（高级用法，按需执行）
• 调整后即时生效，无需重启会话。

四 无显示器 Headless 环境的分辨率设置

• 若服务器无物理显示器导致分辨率过低，可配置内核启动参数与 Xorg：
  • 编辑 /etc/default/grub，设置：GRUB_GFXMODE=1920x1080
  • 更新并重启：sudo update-grub && sudo reboot
  • 如需更精细控制，可在 /etc/X11/xorg.conf.d/ 下创建配置定义 Monitor/ModeLine 与 Screen（适用于虚拟显卡/服务器场景）。

五 常见问题与排查

• 端口与显示编号：会话 :1 对应 5901，:2 对应 5902；查看会话：vncserver -list；结束会话：vncserver -kill :1
• 桌面环境差异：不同桌面在 ~/.vnc/xstartup 的启动命令不同（如 gnome-session、startxfce4 &），请确保与已安装桌面匹配并赋予可执行权限：chmod +x ~/.vnc/xstartup
• 安全建议：公网环境建议通过 SSH 端口转发访问 VNC，例如：ssh -L 59000:localhost:5901 -C -N -l user server_ip，客户端连接 localhost:59000。