调试程序时,经常会遇到一串看不懂的编码文本。每次临时寻找在线转换网站,既容易打断工作,也要重新判断工具是否合适。这次做一个小实验:把 CyberChef 部署到自己的 Ubuntu,再通过星空组网,在 Mac 浏览器里打开它,完成一段文本的编码和还原。
整个项目只有一个配置文件。跟着做完,可以掌握登录组网、创建项目、启动容器、远程访问和验证结果的完整过程。
一、准备环境,先分清两端
CyberChef 是一个可以在浏览器中组合文本处理操作的工具,本篇只用到 Base64。服务器负责提供页面,具体转换由浏览器执行;这里的“私人”指工具入口部署在自己的组网环境中,并不表示添加了应用账号系统。软件本身也支持本地使用,自建入口主要方便不同设备访问同一套工具。
本次使用的环境如下,地址需要替换成自己客户端显示的实际值。
| 设备 | 作用 | 组网地址 |
|---|---|---|
| Mac | 浏览器访问与结果验证 | 192.168.188.1 |
| Ubuntu 22.04 | 运行 CyberChef 容器 | 192.168.188.5 |
Ubuntu 已装好 Docker 和 Compose,下面的服务器命令在具有 Docker 操作权限的终端执行。这里使用已有客户端和成员,不重复安装,也不新建重复账号。
可以把这次实验理解为两件事:先让电脑与服务器能够通过组网地址通信,再在服务器上提供一个网页工具。组网软件不会替你创建 CyberChef 项目,容器也不会自动让所有设备互通。因此,下面先确认设备在线,再部署应用,每一步都有可以核对的结果。
二、从官网登录,让两台设备在线
打开星空组网官网,点击“后台管理”或“立即体验”。没有登录时,选择账号登录或微信扫码,按页面提示进入管理后台。截图保留空白表单,实际使用已有登录状态,不展示账号密码。

第一次配置时,进入“设备管理 → 成员列表”,通过“添加成员”为 Mac 和 Ubuntu 分别准备账号,再让两端客户端各自登录。官网账号用于后台管理,设备成员用于客户端接入;不要把同一个成员同时给多台长期在线设备使用。
客户端尚未安装的读者,可以按官方 MacOS 文档和 Linux 文档完成安装。Linux 安装后根据终端提示打开控制台登录,等待显示虚拟 IP,再继续下面步骤。
本次 Mac 登录后,后台显示两台设备在线。在线状态是开始访问的前提,后面还要实际打开服务确认链路可用。

三、创建一个独立项目
先在 Ubuntu 检查 Docker、Compose 和本次准备使用的端口:
docker --version
docker compose version
ip -brief -4 addr
ss -ltn '( sport = :18089 )'
最后一条只输出表头、没有监听记录,表示检查时该端口空闲;如果已有程序占用,就换一个空闲端口,并同步修改后面的配置和访问地址。本次实际版本为 Docker 29.1.3、Compose 2.40.3。

创建独立目录,避免混进已有项目。普通用户可先用 sudo mkdir 创建目录,再由管理员授予当前用户目录写入权限;本次终端使用 root。
mkdir /opt/cyberchef-lab-20260922
cd /opt/cyberchef-lab-20260922
cat > compose.yaml <<'YAML'
services:
cyberchef:
image: ghcr.io/gchq/cyberchef:11.5.0
ports:
- "192.168.188.5:18089:8080"
restart: "no"
YAML
docker compose config -q
镜像来自 CyberChef 官方仓库,这里固定为本次实测版本,方便以后复现。端口配置依次表示“宿主机组网 IP、访问端口、容器内部端口”。绑定前必须确认该组网 IP 已存在于服务器上;如果照抄了别人的地址,容器可能无法启动。
restart: "no" 让这个短期实验不会随 Docker 自动恢复运行。本例没有挂载数据目录,也不保存用户资料;重点是先把工具部署和使用流程跑通。
Compose 用缩进表示层级,复制时保留空格,不要把缩进换成制表符。docker compose config -q 没有输出且正常结束,说明配置能够被解析;它不会下载镜像,也不能证明服务已经可以访问,下一节才会检查实际运行情况。

四、启动服务,再从Mac访问
仍在项目目录中执行:
docker compose pull
docker compose up -d
docker compose ps
curl --noproxy '*' --max-time 10 -I http://192.168.188.5:18089/
拉取镜像需要服务器能访问官方镜像仓库。下载期间不要因为终端暂时没有新内容就重复创建项目;出现明确错误时,先保留报错,再检查网络和镜像标签。
本次实操遇到服务器下载缓慢,因此中止直拉,在 Mac 从同一官方仓库取得 linux/amd64 镜像,核验镜像层摘要后打包,通过 SFTP 上传,并在 Ubuntu 校验归档后导入。采用归档方式时,用下面命令替代 pull,再执行前面的启动命令:
docker load -i cyberchef-11.5.0-amd64.tar
docker compose up -d
归档必须对应官方镜像及目标服务器架构;网络正常时直接 pull 更方便。本次导入后,页面的“About / Support”显示版本为 v11.5.0。

实际检查结果为容器 running、映射地址 192.168.188.5:18089,Ubuntu 与 Mac 的 HTTP 请求均返回 200 OK。
回到 Mac,保持星空客户端在线,在浏览器地址栏输入 http://192.168.188.5:18089/。这里使用的是 Ubuntu 的组网地址,不能写 localhost,否则访问的是 Mac 自己。本配置只发布到组网地址,其他设备能否访问仍取决于现有组网权限与网络规则。
五、做一次编码,再把文字还原
打开页面后,可以看到左侧操作列表、中间 Recipe(处理步骤),以及右侧 Input 和 Output。先在左侧找到或搜索 To Base64,双击它加入 Recipe,再在 Input 输入下面这段文字,不要多加空格或换行:
Hello StarVPN
保持 Auto Bake 开启,输出应为:
SGVsbG8gU3RhclZQTg==

接下来点击 Recipe 顶栏的垃圾桶按钮清空步骤,双击左侧 From Base64,把 Input 的全部内容替换为刚才的编码结果。Output 应恢复为 Hello StarVPN。注意要替换原来的步骤:若保留 To Base64 又输入已编码文本,会得到另一层编码。

为了检查浏览器结果,可以在 Mac 或 Ubuntu 用 Python 3 的 base64 标准库再算一次,不需要安装第三方包:
python3 - <<'PY'
import base64
text = "Hello StarVPN"
encoded = base64.b64encode(text.encode("utf-8")).decode("ascii")
decoded = base64.b64decode(encoded, validate=True).decode("utf-8")
print("编码:", encoded)
print("解码:", decoded)
assert decoded == text
PY
本次在浏览器、Mac 和 Ubuntu 分别验证,两项结果一致,往返断言通过。Base64 只是数据表示方式,可以直接还原,不属于密码加密,不要用它保护密码。本次只输入演示文本;以后处理实际内容时,也要留意复制、下载和分享链接的范围。
第一次练习建议使用这段英文,便于直接比对每一个字符。掌握步骤后可以换成中文,但代码中应继续明确使用 UTF-8。看起来相同的文字,如果包含不同的换行或不可见空格,编码结果也会不同;这是输入字节发生变化,并不一定是工具出了问题。
六、遇到问题先定位,用完停止实验
如果浏览器打不开,先看两端客户端是否在线,再核对虚拟 IP 和端口。随后在 Ubuntu 查看容器状态与日志:
cd /opt/cyberchef-lab-20260922
docker compose ps -a
docker compose logs --tail=30 cyberchef
服务器本地能打开、Mac 打不开时,重点检查组网路径和访问规则;不要直接关闭整机防火墙。如果页面能打开但结果不同,先核对 Recipe、输入末尾换行和 Auto Bake 状态,把网络问题与文本处理问题分开检查。
用完后停止本次项目:
docker compose stop
docker compose ps -a
ss -ltn '( sport = :18089 )'

实测容器正常退出,状态为 Exited (0);Ubuntu 的 18089 端口没有监听记录,Mac 再次连接该端口也被拒绝。
项目配置和已下载的镜像仍然保留。下次先确认组网地址没有变化,再进入同一目录执行 docker compose up -d,就能继续使用这个小工具箱。
977



被折叠的 条评论
为什么被折叠?



