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

https://dl.codextwin.com/downloads/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

https://dl.codextwin.com/downloads/domestic/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 登录密码。

排查

管理员的命令行环境和普通桌面账户不是同一套家目录。不要把管理员家目录里的配置直接复制给桌面账户,也不要为了读到那些文件而用管理员启动 Codex Twin。

系统更新提示可以先稍后提醒,在维护时间单独处理。