LINUX GUIDE · UBUNTU 22.04.5 x86_64
在 Ubuntu 22.04.5 上安装 Codex Twin .6
这份教程只覆盖 Ubuntu 22.04.5 LTS、x86_64。它不是所有 Linux 发行版的通用安装说明。版本是 0.6.5-software-free.20261114.6.localtest.1。
国际版和国内版命令步骤相同,文件名不同。请按自己要装的那一版复制完整文件名,不要用 Codex-Twin*.AppImage 这类通配,以免装错版本。
ubuntuuser 只是示例桌面账户名。请换成你自己的普通桌面账户。下面不描述任何一台真实服务器上已经有哪些账户或服务。
视频基于早期演示编辑,安装包、命令与路径已更新至0.6.5-software-free.20261114.6.localtest.1;请以本页图文为准,并非新版实机录屏。
先选对安装包
国际版
文件名 Codex-Twin-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage
SHA-256 e3c2d64721e208760c113fceb430988b9cd90e1a42247118ef5e4ecde88acdde
国内版
文件名 Codex-Twin-Domestic-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage
SHA-256 829dcfb1d99d7c0dedb2d8d6e3e3ef47a8cd54d1104d3cc0bcb3acc9ce1418ad
管理员下载后,在放文件的目录里核对自己这一版的完整文件名。字母大小写不影响比较,64 位必须全部一致。
sha256sum "Codex-Twin-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage"
sha256sum "Codex-Twin-Domestic-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage"
只运行你下载的那一条。不一致就删除文件,从上面的 HTTPS 地址重新下载。
管理员安装文件
下面带 apt-get、cp 到 /opt 的命令只由管理员执行。已经有图形桌面的人,不必安装后面的远程桌面。
Ubuntu 22.04 上运行这类 AppImage 需要 libfuse2。只装这个库,不必因此安装远程桌面:
apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y libfuse2
如果 apt 提示有可自动删除的软件包,不要因此执行 apt autoremove -y。
国际版放到固定目录
install -d -m 755 /opt/codex-twin
install -m 755 \
"./Codex-Twin-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage" \
"/opt/codex-twin/Codex-Twin-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage"
ls -lh "/opt/codex-twin/Codex-Twin-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage"
国内版放到另一个目录
install -d -m 755 /opt/codex-twin-cn
install -m 755 \
"./Codex-Twin-Domestic-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage" \
"/opt/codex-twin-cn/Codex-Twin-Domestic-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage"
ls -lh "/opt/codex-twin-cn/Codex-Twin-Domestic-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage"
AppImage 不需要 dpkg。上面的文件本身就是程序。两版可以同时放在机器上,因为目录和文件名都不同。
用普通桌面账户启动
在示例账户 ubuntuuser 的图形桌面里打开终端,不要在管理员的 SSH 终端里启动,不要使用 sudo,也不要加 --no-sandbox。
/opt/codex-twin/Codex-Twin-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage
/opt/codex-twin-cn/Codex-Twin-Domestic-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage
只运行已安装的那一版。
可选:给这个示例账户加应用菜单。管理员执行时,把 ubuntuuser 换成实际桌面账户。国际版:
install -d -m 755 -o ubuntuuser -g ubuntuuser /home/ubuntuuser/.local/share/applications
cat > /home/ubuntuuser/.local/share/applications/codex-twin.desktop <<'DESKTOP'
[Desktop Entry]
Type=Application
Name=Codex Twin
Comment=Codex Twin desktop client
Exec=/opt/codex-twin/Codex-Twin-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage
Terminal=false
Categories=Development;
DESKTOP
chown ubuntuuser:ubuntuuser /home/ubuntuuser/.local/share/applications/codex-twin.desktop
chmod 644 /home/ubuntuuser/.local/share/applications/codex-twin.desktop
国内版使用另一个文件名和启动路径:
install -d -m 755 -o ubuntuuser -g ubuntuuser /home/ubuntuuser/.local/share/applications
cat > /home/ubuntuuser/.local/share/applications/codex-twin-cn.desktop <<'DESKTOP'
[Desktop Entry]
Type=Application
Name=Codex Twin 国内版
Comment=Codex Twin domestic desktop client
Exec=/opt/codex-twin-cn/Codex-Twin-Domestic-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage
Terminal=false
Categories=Development;
DESKTOP
chown ubuntuuser:ubuntuuser /home/ubuntuuser/.local/share/applications/codex-twin-cn.desktop
chmod 644 /home/ubuntuuser/.local/share/applications/codex-twin-cn.desktop
可选:只给没有图形桌面的机器安装远程桌面
这台说明面向从 Windows 用 SSH 管理、机器上还没有图形桌面的情况。已经能在本机显示器或现有远程桌面里登录的普通用户,跳过这一整节。
需要远程桌面时,由管理员安装 XRDP 和 XFCE。安装这个软件包时,服务可能立刻按自带配置启动,那时监听地址还不一定是回环。管理员先确认防火墙不会把 3389 暴露到局域网或公网,再安装。装完不要单独执行启动命令。最终只通过 127.0.0.1 和 SSH 隧道访问。
apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends xrdp xorgxrdp xfce4 xfce4-terminal dbus-x11
如果希望示例账户 ubuntuuser 的 XRDP 会话使用 XFCE,先备份再写入。账户已有 .xsession 时会留下带时间的备份:
id ubuntuuser
if [ -f /home/ubuntuuser/.xsession ]; then
cp -a /home/ubuntuuser/.xsession "/home/ubuntuuser/.xsession.bak-$(date +%Y%m%d-%H%M%S)"
fi
printf '#!/bin/sh\nexec startxfce4\n' > /home/ubuntuuser/.xsession
chown ubuntuuser:ubuntuuser /home/ubuntuuser/.xsession
chmod 700 /home/ubuntuuser/.xsession
改完后需要从桌面注销再登录,新的会话设置才会用上。忘记示例账户密码时,管理员可以执行 passwd ubuntuuser,输入两次新密码。密码记得就不要改。
只改 [Globals] 里的 port
下面从备份、检查、写入到 enable 和 restart 是同一段。请整段复制,包括首行 bash 和最后一行 XRDP_BLOCK。[Globals] 里的 port= 不是唯一一行时,这一段在启动服务之前结束,后面的 usermod、enable 和 restart 不会执行。
bash -euo pipefail <<'XRDP_BLOCK'
set -euo pipefail
cp -a /etc/xrdp/xrdp.ini "/etc/xrdp/xrdp.ini.bak-$(date +%Y%m%d-%H%M%S)"
python3 - <<'PY'
from pathlib import Path
import sys
path = Path("/etc/xrdp/xrdp.ini")
lines = path.read_text().splitlines(keepends=True)
in_globals = False
seen = 0
out = []
for line in lines:
stripped = line.strip()
if stripped.startswith("[") and stripped.endswith("]"):
in_globals = stripped == "[Globals]"
out.append(line)
continue
if in_globals and stripped.startswith("port="):
seen += 1
indent = line[:len(line) - len(line.lstrip(" \t"))]
ending = "\n" if line.endswith("\n") else ""
out.append(f"{indent}port=tcp://127.0.0.1:3389{ending}")
continue
out.append(line)
if seen != 1:
sys.exit(f"[Globals] 中的 port= 有 {seen} 行,已停止,文件未改")
path.write_text("".join(out))
print("已把 [Globals] 的 port= 改为 tcp://127.0.0.1:3389")
PY
usermod -aG ssl-cert xrdp
systemctl enable --now xrdp-sesman xrdp
systemctl restart xrdp
systemctl is-active xrdp xrdp-sesman
ss -lntp | grep ':3389'
XRDP_BLOCK
预期看到 xrdp 监听 127.0.0.1:3389。这段若中途停止,不要接着手工执行 usermod 或 systemctl enable。打开备份对照,只手工修改 [Globals] 节中的 port=,确认已是回环地址后,再单独启动服务。不要改其他节里的端口。
Windows 经 SSH 隧道连接
主机名和账户用占位符 example-host、example-user。这里没有真实服务器地址或密码。两种方法二选一。
方法 A,SSH 客户端的本地转发:本地监听 127.0.0.1 端口 3390,目标 127.0.0.1 端口 3389。目标不要写成 localhost。隧道保持在线后,Windows 远程桌面连接 127.0.0.1:3390。
方法 B,PowerShell。本地也显式绑在 127.0.0.1:
ssh -N -L 127.0.0.1:13389:127.0.0.1:3389 example-user@example-host
SSH 不是 22 端口时,在命令末尾加 -p 和端口。保持这个窗口运行,远程桌面填写 127.0.0.1:13389。3390 只属于方法 A,13389 只属于方法 B。
XRDP 登录页选择 Session:Xorg。用户名填实际桌面账户;示例写法是 ubuntuuser 和该账户自己的 Ubuntu 密码。这不是 Windows 登录密码。
排查
- 提示
Running as root without --no-sandbox is not supported:当前用管理员启动了程序。改到普通桌面账户的图形终端运行,不要 sudo,也不要加--no-sandbox。 - 提示
cannot open display或DISPLAY为空:这条 SSH 终端没有图形会话。到已经登录的图形桌面里再启动。 - 提示缺少
libfuse.so.2:管理员执行apt-get install -y libfuse2。 - 隧道目标连不上时,管理员先看
systemctl is-active xrdp xrdp-sesman和ss -lntp | grep ':3389'。没有监听时再systemctl restart xrdp-sesman xrdp,然后看journalctl -u xrdp -u xrdp-sesman -n 80 --no-pager。 - XRDP 认证失败时看
tail -50 /var/log/xrdp-sesman.log。那是桌面账户的密码问题。管理员可以用passwd重置该账户,不要去改 Windows 密码。 - 登录后是别的桌面而不是 XFCE:看该账户的
~/.xsession是否为exec startxfce4,注销后重登。 - Windows 提示会话因数据加密错误结束:先看 SSH 隧道是否还在,再看 xrdp 是否仍只监听
127.0.0.1:3389。
管理员的命令行环境和普通桌面账户不是同一套家目录。不要把管理员家目录里的配置直接复制给桌面账户,也不要为了读到那些文件而用管理员启动 Codex Twin。
系统更新提示可以先稍后提醒,在维护时间单独处理。