Nexus4CC 手机电脑同步claude code对话部署教程（基于linux系统）

这里写自定义目录标题

- 概述
- [Nexus4CC 是一个 WebSocket + tmux 的终端桥接工具，可以让手机和电脑同时访问同一个终端会话，两端实时同步显示和输入。](#Nexus4CC 是一个 WebSocket + tmux 的终端桥接工具，可以让手机和电脑同时访问同一个终端会话，两端实时同步显示和输入。)
- 一、系统要求
- 二、完整部署步骤
- - [2.1 克隆项目](#2.1 克隆项目)
  - [2.2 配置环境变量](#2.2 配置环境变量)
  - [2.3 安装后端依赖](#2.3 安装后端依赖)
  - [2.4 安装 tmux（重要！）](#2.4 安装 tmux（重要！）)
  - [2.5 构建前端](#2.5 构建前端)
  - [2.6 一键启动（推荐）](#2.6 一键启动（推荐）)
  - [2.7 手动启动（可选）](#2.7 手动启动（可选）)
- 三、网络访问配置
- - [3.1 局域网访问](#3.1 局域网访问)
  - [3.2 远程访问（手机用5G/4G）](#3.2 远程访问（手机用5G/4G）)
  - - [3.2.1 添加 Tailscale 官方源（银河麒麟Kylin系统）](#3.2.1 添加 Tailscale 官方源（银河麒麟Kylin系统）)
    - [3.2.2 启动 Tailscale](#3.2.2 启动 Tailscale)
    - [3.2.3 完成认证](#3.2.3 完成认证)
    - [3.2.4 确认连接](#3.2.4 确认连接)
  - [3.3 防火墙配置](#3.3 防火墙配置)
- 四、访问地址汇总
- 五、日常管理命令
- 六、常见问题及解决方案
- - [Q1: 访问页面显示"正在加载"或白屏](#Q1: 访问页面显示"正在加载"或白屏)
  - [Q2: tmux session 初始化失败](#Q2: tmux session 初始化失败)
  - [Q3: 手机无法访问（同一WiFi也不行）](#Q3: 手机无法访问（同一WiFi也不行）)
  - [Q4: 手机用5G网络无法访问](#Q4: 手机用5G网络无法访问)
  - [Q5: Tailscale 安装失败](#Q5: Tailscale 安装失败)
  - [Q6: 电脑端无法使用输入法输入中文](#Q6: 电脑端无法使用输入法输入中文)
  - [Q7: 中文输入法只能一个字一个字打，不能按数字选字](#Q7: 中文输入法只能一个字一个字打，不能按数字选字)
  - [Q8: PM2 显示服务 online 但无法访问](#Q8: PM2 显示服务 online 但无法访问)
  - [Q9: 每次重启服务器后需要手动启动](#Q9: 每次重启服务器后需要手动启动)
  - [Q10: Tailscale 连接成功但无法ping通](#Q10: Tailscale 连接成功但无法ping通)
- 七、项目信息
- 八、注意事项
- 功能快捷键
- 合理的创建标题，有助于目录的生成
- 如何改变文本的样式
- 插入链接与图片
- 如何插入一段漂亮的代码片
- 生成一个适合你的列表
- 创建一个表格
- - 设定内容居中、居左、居右
  - SmartyPants
- 创建一个自定义列表
- 如何创建一个注脚
- 注释也是必不可少的
- KaTeX数学公式
- 新的甘特图功能，丰富你的文章
- UML图表
- 流程图
- FLowchart流程图
- 导出与导入
- - 导出
  - 导入

概述

Nexus4CC 是一个 WebSocket + tmux 的终端桥接工具，可以让手机和电脑同时访问同一个终端会话，两端实时同步显示和输入。

一、系统要求

服务器：Linux 系统（需要 Node.js 20+）
手机/电脑：任何现代浏览器
网络：手机和电脑都能访问服务器（局域网或通过 Tailscale 内网穿透）

二、完整部署步骤

2.1 克隆项目

bash 复制代码

# 切换到你想要存放项目的目录，示例为/opt，可自行替换
cd /opt
git clone https://github.com/librae8226/nexus4cc.git
cd nexus4cc

2.2 配置环境变量

bash 复制代码

cp .env.example .env

编辑 .env 文件，设置以下必填项：

env 复制代码

JWT_SECRET=你的JWT密钥（随机字符串）
ACC_PASSWORD_HASH=你的登录密码（bcrypt加密）
PORT=59000

生成密码哈希 （可选，默认密码是 nexus123）：

bash 复制代码

node -e "console.log(require('bcrypt').hashSync('你的密码', 10))"

2.3 安装后端依赖

bash 复制代码

npm install

2.4 安装 tmux（重要！）

bash 复制代码

sudo apt install tmux

验证 tmux 已安装：

bash 复制代码

tmux -V

2.5 构建前端

bash 复制代码

cd frontend
npm install
npm run build
cd ..

2.6 一键启动（推荐）

bash 复制代码

npm run setup

这个命令会：

检查 Node.js 版本
安装/检查 tmux
安装 PM2 进程管理器
构建前端
启动服务

2.7 手动启动（可选）

bash 复制代码

pm2 start ecosystem.config.cjs

三、网络访问配置

3.1 局域网访问

服务器监听 0.0.0.0:59000，同一局域网内的设备可直接访问：

地址格式 ：http://你的服务器局域网IP:59000
示例：http://192.168.1.100:59000

3.2 远程访问（手机用5G/4G）

使用 Tailscale 内网穿透：

3.2.1 添加 Tailscale 官方源（银河麒麟Kylin系统）

bash 复制代码

# 添加 apt 源
echo 'deb https://pkgs.tailscale.com/stable/ubuntu jammy main' | sudo tee /etc/apt/sources.list.d/tailscale.list
# 导入签名密钥
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/jammy.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg
# 安装
sudo apt update
sudo apt install tailscale

注意：不要用官方 install.sh 脚本，Kylin 系统无法识别。也不要下载静态包（可能损坏）。

3.2.2 启动 Tailscale

bash 复制代码

# 启动守护进程（用户空间模式，不需要TUN设备）
sudo tailscaled --tun=userspace-networking &
# 等待启动
sleep 3
# 连接认证（会显示认证URL）
sudo tailscale up

3.2.3 完成认证

终端会显示类似：

复制代码

To authenticate, visit:
    https://login.tailscale.com/a/xxxxxxxxxxxx

在浏览器打开这个链接，用 Tailscale 账号登录完成认证。

3.2.4 确认连接

bash 复制代码

tailscale status

显示类似：

复制代码

100.xxx.xxx.xxx  你的服务器设备名          你的账号@  linux
100.xxx.xxx.xxx  你的windows设备名         你的账号@  windows  offline
100.xxx.xxx.xxx  你的安卓手机设备名        你的账号@  android

3.3 防火墙配置

bash 复制代码

# 临时禁用防火墙（测试用）
sudo ufw disable
# 或开放特定端口
sudo ufw allow 59000/tcp
sudo ufw allow 41641/udp  # Tailscale WireGuard

四、访问地址汇总

场景	地址
电脑同局域网	http://你的服务器局域网IP:59000
手机远程访问	http://你的Tailscale服务器IP:59000
默认密码	nexus123

五、日常管理命令

bash 复制代码

# 查看状态
pm2 status nexus
# 查看日志
pm2 logs nexus
# 重启服务
pm2 restart nexus
# 停止服务
pm2 stop nexus
# Tailscale 状态
tailscale status
# Tailscale 断开
sudo tailscale down
# Tailscale 重连
sudo tailscale up

六、常见问题及解决方案

Q1: 访问页面显示"正在加载"或白屏

原因：前端未构建或构建失败
解决：

bash 复制代码

cd nexus4cc/frontend
npm run build
cd ..
pm2 restart nexus

Q2: tmux session 初始化失败

原因：tmux 未安装
解决：

bash 复制代码

sudo apt install tmux
pm2 restart nexus

Q3: 手机无法访问（同一WiFi也不行）

原因：防火墙阻止
解决：

bash 复制代码

sudo ufw disable

Q4: 手机用5G网络无法访问

原因：需要 Tailscale 内网穿透
解决：按 3.2 节配置 Tailscale

Q5: Tailscale 安装失败

原因：银河麒麟系统不兼容官方 install.sh
解决：

不要用 curl -fsSL https://tailscale.com/install.sh | sh
使用 apt 源安装（见 3.2.1）
不要用静态包（可能损坏）
验证 Tailscale 安装正确：

bash 复制代码

/usr/bin/tailscale version
# 应该显示版本号，如：1.96.4

如果显示 tailscaled does not take non-flag arguments，说明二进制文件损坏，需要重新安装。

Q6: 电脑端无法使用输入法输入中文

原因：xterm.js 在某些浏览器/Linux 发行版上 IME 支持不完整
解决：

使用 Chromium 浏览器（不是奇安信/360）
手机端不受影响，可以正常输入中文
临时用复制粘贴代替
安装 Chromium：

bash 复制代码

sudo apt install chromium-browser
chromium-browser http://你的服务器IP:59000

Q7: 中文输入法只能一个字一个字打，不能按数字选字

原因：xterm.js 5.x 在 Linux 上的已知限制
解决：

用鼠标点击选择候选字，而不是按数字
或者在文本编辑器输入 → 复制 → Ctrl+V 粘贴

Q8: PM2 显示服务 online 但无法访问

原因：服务可能仍在启动中
解决：

bash 复制代码

pm2 logs nexus --lines 20
# 查看日志确认 "Nexus listening on :59000"

Q9: 每次重启服务器后需要手动启动

解决：设置 PM2 开机自启

bash 复制代码

pm2 startup
pm2 save

Q10: Tailscale 连接成功但无法ping通

原因：防火墙阻止 UDP 41641 端口
解决：

bash 复制代码

sudo ufw disable
# 或
sudo iptables -P INPUT ACCEPT
sudo iptables -P OUTPUT ACCEPT

七、项目信息

GitHub: https://github.com/librae8226/nexus4cc
默认端口: 59000
默认密码: nexus123（建议修改）

八、注意事项

密码安全：生产环境务必修改默认密码
网络隔离：Tailscale IP 不要随意公开
防火墙：确保 59000 端口和 Tailscale UDP 端口开放
备份配置 ：.env 文件包含敏感信息，建议备份
日志监控 ：定期检查 pm2 logs nexus 排查问题器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：
全新的界面设计 ，将会带来全新的写作体验；
在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
全新的 KaTeX数学公式 语法；
增加了支持甘特图的mermaid语法^{[1](#甘特图的mermaid语法1)} 功能；
增加了 多屏幕编辑 Markdown文章功能；
增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z

重做：Ctrl/Command + Y

加粗：Ctrl/Command + B

斜体：Ctrl/Command + I

标题：Ctrl/Command + Shift + H

无序列表：Ctrl/Command + Shift + U

有序列表：Ctrl/Command + Shift + O

检查列表：Ctrl/Command + Shift + C

插入代码：Ctrl/Command + Shift + K

插入链接：Ctrl/Command + Shift + L

插入图片：Ctrl/Command + Shift + G

查找：Ctrl/Command + F

替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。

输入2次#，并按下space后，将生成2级标题。

以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

javascript 复制代码

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

项目
- 项目
  - 项目

项目1
项目2
项目3

计划任务
完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中

使用:----------居左

使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants 是一个文本转换工具，主要功能是将普通的 ASCII 标点符号自动转换为更美观的印刷体标点符号。例如：

原始符号	转换后	说明
`"引号"`	"引号"	直引号变弯引号
`'单引号'`	'单引号'	直单引号变弯单引号
`--`	--	两个连字符变短破折号
`---`	---	三个连字符变长破折号
`...`	...	三个点变省略号

创建一个自定义列表

:
Text-to- conversion tool
:
John
:
Luke

如何创建一个注脚

一个具有注脚的文本。^[2](#2)

注释也是必不可少的

Markdown将文本转换为。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n−1)!∀n∈N 是通过欧拉积分

Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=∫0∞tz−1e−tdt.

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能，丰富你的文章

2014-01-07 2014-01-09 2014-01-11 2014-01-13 2014-01-15 2014-01-17 2014-01-19 2014-01-21 已完成进行中计划一计划二现有任务 Adding GANTT diagram functionality to mermaid

关于 甘特图 语法，参考这儿,

UML图表

可以使用UML图表进行渲染，例如下面产生的一个序列图：
王五李四张三王五李四张三李四想了很长时间, 文字太长了不适合放在一行. 你好！李四, 最近怎么样? 你最近怎么样，王五？我很好，谢谢! 我很好，谢谢! 打量着王五... 很好... 王五, 你怎么样?

关于 UML图表 语法，参考这儿,

流程图

链接
长方形
圆
圆角长方形
菱形

关于 Mermaid 语法，参考这儿,

FLowchart流程图

我们依旧会支持flowchart.js的流程图语法：
Created with Raphaël 2.3.0 开始我的操作确认？结束 yes no

关于 Flowchart流程图 语法，参考这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，

继续你的创作。

mermaid语法说明 ↩︎
注脚的解释 ↩︎

*[HTML]: 超文本标记语言