💻 前言

最近在给Ubuntu Server纯命令行版部署X-Edge干将互联做内网穿透，踩了超多坑：原生系统无外网访问权限，直接执行安装命令完全没响应；国内镜像源又频繁出现GPG密钥验证失败、仓库未签名报错，试了多种方案都失败。

最终摸索出一套先通过局域网传包部署Xray代理，再安装Tailscale底层客户端，最后接入X-Edge组网的完整流程，完美解决无外网、动态IP环境下的多设备远程访问问题，Mac、手机、Linux服务器可直接组成虚拟局域网，不受家庭宽带动态IP限制，全程亲测有效，分享给大家避坑。

核心痛点：Ubuntu Server原生环境无法访问国外安装源，国内镜像源密钥失效；必须先配置代理才能正常执行安装命令，实现X-Edge组网。

📋 软硬件环境清单

设备	系统环境	网络环境	核心用途
Linux服务器	Ubuntu 24.04 LTS Server（纯命令行，无桌面）	家庭局域网，动态公网IP，无直接外网访问权限	核心服务部署，X-Edge服务端节点
Mac电脑	macOS 任意版本	与Linux服务器同局域网，可正常访问外网	SSH远程操作、文件传输、X-Edge组网节点
手机	iOS/Android	移动网络/局域网均可	移动组网，远程访问服务器
核心工具	OpenSSH、FileZilla、Xray、Tailscale、X-Edge干将互联	-	远程连接、文件传输、代理、内网穿透

⚠️ 前置准备工作

1. 局域网环境准备

• 确保Mac电脑和Ubuntu Server连接同一路由器，处于同一局域网，可互相ping通

• Ubuntu Server默认开启SSH服务，提前记录服务器局域网IP、登录用户名、登录密码

• Mac电脑可正常访问外网，提前下载好适配Linux的Xray安装包（amd64架构）

2. 工具准备

• Mac端安装FileZilla（SFTP文件传输工具，用于上传Xray安装包到服务器）

• 提前注册X-Edge干将互联账号，确保可正常登录后台

🚀 完整部署步骤（保姆级，复制即可）

步骤1：Mac通过SSH远程连接Ubuntu Server

打开Mac终端，执行以下命令，替换为自己的服务器信息：

ssh 你的Ubuntu用户名@服务器局域网IP

输入服务器登录密码，终端提示符切换为用户名@主机名，代表连接成功，可正常执行Linux命令。

步骤2：FileZilla上传Xray安装包到服务器

1. 打开Mac端FileZilla，选择SFTP协议，填写连接参数：

   • 主机：服务器局域网IP

   • 端口：22（SSH默认端口）

   • 用户名：Ubuntu登录用户名

   • 密码：Ubuntu登录密码

2. 点击快速连接，左侧选择Mac本地下载好的Xray安装包，右侧拖拽到服务器/home/用户名/目录下

3. 回到SSH终端，执行ls命令，能看到Xray安装包，代表上传成功

步骤3：部署Xray代理，解决外网访问限制

Ubuntu Server无外网无法直接安装X-Edge，必须先配置代理，执行以下操作：

1. 解压Xray安装包（根据自己的包名修改）：
   tar -zxvf Xray安装包名.tar.gz

2. 完成Xray安装与基础配置，启动Xray服务

3. 配置终端代理环境变量，让当前会话走代理外网：
   export http_proxy=http://127.0.0.1:你的代理端口 export https_proxy=http://127.0.0.1:你的代理端口

4. 验证代理是否生效：
   curl https://www.google.com

出现正常网页响应，代表代理配置成功，可正常访问外网安装源。

关键注意：代理必须保持生效，后续安装命令全程在该代理会话中执行，关闭终端需重新配置代理变量。

步骤4：代理环境下安装Tailscale（X-Edge底层依赖）

X-Edge干将互联基于Tailscale客户端，放弃报错的国内镜像源，直接用官方源安装，全程无密钥报错：

curl -fsSL https://tailscale.com/install.sh | sh

等待脚本自动执行，终端出现Installation complete!，代表安装成功。

验证安装：

tailscale --version

正常输出版本号，无报错即可进行下一步。

步骤5：登录X-Edge干将互联，接入虚拟局域网

执行专属登录命令，指定X-Edge登录服务器，而非官方Tailscale节点：

sudo tailscale up --login-server https://login.xedge.cc

1. 执行后终端会生成一个登录链接，复制链接到Mac浏览器打开

2. 登录自己的X-Edge干将互联账号，完成设备授权，页面提示Success

3. 回到SSH终端，查看服务器分配的永久固定虚拟IP：
   tailscale ip -4

会得到100.xxx.xxx.xxx格式的IP，这个IP不受家庭动态IP影响，永久不变，后续远程访问全靠它。

步骤6：Mac+手机多设备组网，实现全局访问

1. Mac端接入：下载X-Edge客户端，登录同一账号，自动加入虚拟局域网，可查看Mac虚拟IP

2. 手机端接入：应用商店搜索X-Edge，下载对应客户端，登录同一账号，完成接入

3. 组网验证：

   • SSH终端执行tailscale status，可看到所有在线设备及虚拟IP

   • Mac终端ping服务器X-Edge虚拟IP，可正常ping通

   • Mac切换手机热点（断开局域网），仍可ping通并远程连接服务器，内网穿透生效

✅ 组网成功验证标准

• Linux服务器、Mac、手机均登录同一X-Edge账号，处于同一虚拟网段

• 所有设备可通过X-Edge虚拟IP互相访问，不受物理网络、动态IP限制

• 服务器重启后，Tailscale服务自动启动，自动接入X-Edge网络，IP不变

• 家庭路由器重启、宽带IP更换，不影响虚拟局域网访问

❌ 踩坑总结（必看）

1. 镜像源GPG密钥报错：放弃ts-mirror.xedge.cc镜像源，直接用官方源+代理安装，彻底解决密钥失效问题

2. 安装命令无响应：未配置代理，Ubuntu原生无外网权限，必须先部署Xray代理

3. 登录后无虚拟IP：未指定–login-server https://login.xedge.cc，登录到官方Tailscale网络，重新执行登录命令即可

4. 代理失效：终端关闭后代理变量失效，重新执行export代理命令即可

🔧 后续部署指引

X-Edge内网穿透完成后，固定远程IP已就绪，可继续搭建后续服务：

1. Ubuntu Server系统初始化、防火墙安全配置

2. OpenClaw AI网关部署，配置HTTPS远程访问

3. Syncthing跨设备文件同步服务部署

4. Obsidian笔记多端同步配置

5. 所有服务开机自启配置，实现无人值守

📝 结语

这套流程完美解决了Ubuntu Server无外网、动态IP环境下部署X-Edge干将互联的痛点，全程避开镜像源报错、无网络等坑，适合纯命令行服务器、家用宽带动态IP场景，多设备组网后远程管理服务器、访问服务都非常方便。

如果对你有帮助，欢迎点赞、收藏、关注，后续会更新OpenClaw+Syncthing+Obsidian全套部署教程～

原创不易，转载请注明出处，CSDN同步发布～

（注：文档部分内容可能由 AI 生成）