Ubuntu 22.04.5 x86_64 安装 Codex Twin .6 ========================================== 适用环境:Ubuntu 22.04.5 LTS、x86_64。不是全部 Linux 发行版的通用说明。 版本:0.6.5-software-free.20261114.6.localtest.1 视频基于早期演示编辑,安装包、命令与路径已更新至0.6.5-software-free.20261114.6.localtest.1;请以本页图文为准,并非新版实机录屏。 图文与视频:https://codextwin.com/guides/linux-install.html ubuntuuser 只是示例桌面账户名,请换成自己的普通桌面账户。 本文不描述任何真实服务器上已有的账户或服务。 国际版和国内版步骤相同,文件名不同。不要用 Codex-Twin*.AppImage 通配。 一、安装包 ---------- 国际版 文件名:Codex-Twin-0.6.5-software-free.20261114.6.localtest.1-linux-x86_64.AppImage URL: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 URL: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 管理员只核对自己下载的那一个文件: 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" 64 位全部一致再继续。不一致就删除并从上面的 HTTPS 地址重新下载。 二、管理员安装文件 ------------------ 已有图形桌面的人不必安装远程桌面。 Ubuntu 22.04 运行这类 AppImage 需要 libfuse2。这一步不安装 XRDP: 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" 不使用 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 软件包时,服务可能立刻按自带配置启动,那时监听地址还不一定是回环。管理员先确认防火墙不会把 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 备份并设置示例账户的 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。记得密码就不要改。 下面从备份、检查、写入到 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=,确认已是回环地址后,再单独启动服务。 SSH 使用占位主机 example-host 和占位账户 example-user,没有真实凭据。 方法 A:本地转发,本地监听 127.0.0.1:3390,目标 127.0.0.1:3389。Windows 远程桌面连接 127.0.0.1:3390。 方法 B,与方法 A 不要同时占用同一条说明里的端口: 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。 - 认证失败:tail -50 /var/log/xrdp-sesman.log。那是桌面账户密码。管理员用 passwd 重置该账户。 - 登录后不是 XFCE:检查该账户 ~/.xsession 是否为 exec startxfce4,注销后重登。 - Windows 提示会话因数据加密错误结束:先看 SSH 隧道是否还在,再看 xrdp 是否仍只监听 127.0.0.1:3389。 不要把管理员家目录里的配置复制给桌面账户,也不要用管理员启动 Codex Twin。