Linux 命令速查

更新系统

Debian / Ubuntu 上 update 只刷新索引，真正升级要跟上 upgrade。

sudo apt update
sudo apt upgrade -y

# Remove packages that nothing depends on anymore
sudo apt autoremove --purge -y

管理 systemd 服务

# Status, with the last few log lines
systemctl status nginx

# Start now and enable on boot in one go
sudo systemctl enable --now nginx

# Reload unit files after editing them
sudo systemctl daemon-reload

查日志跟着服务走，-f 持续跟随，-n 限制行数：

journalctl -u nginx -n 100 -f

磁盘与目录占用

磁盘写满时按这个顺序查：先看整体，再定位到具体目录。

# Overall usage, human readable
df -h

# Largest entries in the current directory
du -h --max-depth=1 . | sort -h | tail -20

防火墙

sudo ufw status verbose
sudo ufw allow OpenSSH
sudo ufw enable

查进程与端口

# Listening sockets with the owning process
sudo ss -tulpn

# Find a process by name
pgrep -a node

安装 Tailscale

官方安装脚本会按发行版添加 apt 源并安装 tailscale 包，重复执行是安全的。 tailscale up 会打印一个登录 URL，在浏览器里授权后这台机器就进入 tailnet。

sudo apt update
sudo apt install -y curl
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

# Verify: node list and this machine's tailnet IPv4
tailscale status
tailscale ip -4

安装 CC Switch（Ubuntu）

CC Switch 是切换 Claude Code / Codex 等 CLI 供应商配置的桌面工具。 Linux 版从 GitHub Releases 下载 deb 包用 apt 安装，换版本时只改 URL 里的版本号； arm64 机器把 x86_64 换成 arm64。

wget https://github.com/farion1231/cc-switch/releases/download/v3.20.3/CC-Switch-v3.20.3-Linux-x86_64.deb \
  -O /tmp/cc-switch.deb && \
sudo apt install -y /tmp/cc-switch.deb

不想装进系统的话也有 AppImage，下载后加执行权限直接跑：

wget https://github.com/farion1231/cc-switch/releases/download/v3.20.3/CC-Switch-v3.20.3-Linux-x86_64.AppImage \
  -O ~/cc-switch.AppImage && chmod +x ~/cc-switch.AppImage

Wayland + NVIDIA 下如果窗口点不动，用 CC_SWITCH_GDK_BACKEND=wayland 启动。

安装 Clash Verge（Ubuntu）

从 GitHub Releases 下载 deb 包并用 apt 安装，apt 会自动补齐依赖。换版本时只改 URL 里的版本号。

wget https://github.com/Clash-Verge-rev/clash-verge-rev/releases/download/v2.5.2/Clash.Verge_2.5.2_amd64.deb \
  -O /tmp/clash-verge.deb && \
sudo apt install -y /tmp/clash-verge.deb

用 clash.sh 一步到位

上面那条只装程序本体。装完还要开 TUN、改设置、加直连规则、导订阅，这些 clash.sh 都包了。它必须带子命令，不带参数只会打印用法：

# 全流程：install -> settings -> rules -> sub -> check
curl -fsSL https://hub.skillnav.dev/clash.sh | CLASH_SUB_URL='https://你的订阅地址' sh -s -- all

# 也可以单独跑某一步
curl -fsSL https://hub.skillnav.dev/clash.sh | sh -s -- install
curl -fsSL https://hub.skillnav.dev/clash.sh | sh -s -- check

子命令	做什么
`install`	按 `dpkg --print-architecture` 选 amd64/arm64 包，apt 安装，然后装 `clash-verge-service`——TUN 要靠这个 root 服务拿 `CAP_NET_ADMIN`
`settings`	改写 `verge.yaml` 的 20 个键，写入 `dns_config.yaml` 并打开 `enable_dns_settings`
`rules`	把直连规则装进全局脚本增强 `profiles/Script.js`，对所有订阅生效
`sub`	读 `CLASH_SUB_URL`，先把 app 拉起来再投递 `clash://` 深链
`check`	打印 PASS/FAIL/SKIP 体检表，有 FAIL 时退出码为 1

几个必须知道的前提：

settings 要求 app 已退出。 app 运行时会用内存态覆写 verge.yaml，这时候改文件等于白改。脚本检测到进程会直接拒绝；想让它替你关掉就加 CLASH_FORCE_STOP=1。
TUN 依赖服务。 没装 clash-verge-service 时，app 启动会把 enable_tun_mode 强制改回 false。所以 settings 检测不到服务就如实写 false，不会写一个看着生效实际会被打回的 true。
规则走脚本增强，不是 Merge.yaml。 merge 是纯深合并，在里面写 rules: 会整段替换订阅自带的规则； prepend-rules 这个键在上游只存在于单元测试里，没有实现。全局 Script.js 才能真正前插。
订阅地址是机密。 只经环境变量传入，不写进任何文件，打印时只保留协议和域名。

# 预览：只打印将要执行的命令，不下载也不改任何文件
curl -fsSL https://hub.skillnav.dev/clash.sh | HUB_DRY_RUN=1 sh -s -- all

# 固定版本，不取 latest
curl -fsSL https://hub.skillnav.dev/clash.sh | CLASH_VERGE_VERSION=2.5.2 sh -s -- install

手动排查

控制接口在 unix socket 上，不是 127.0.0.1:9097——TCP 外部控制器默认是关的， config.yaml 里那个 9097 是兜底写回的值，不代表真在监听。socket 上不需要鉴权头：

SOCK=/tmp/verge/verge-mihomo.sock
curl -s --unix-socket "$SOCK" http://localhost/version
curl -s --unix-socket "$SOCK" http://localhost/configs

# 出口是否真的通
curl -sS -o /dev/null -w '%{http_code}\n' -m 10 -x http://127.0.0.1:7897 \
  https://cp.cloudflare.com/generate_204   # 期望 204

# TUN 服务状态
systemctl is-active clash-verge-service && test -S /tmp/verge/clash-verge-service.sock && echo ok

配置文件都在 ~/.local/share/io.github.clash-verge-rev.clash-verge-rev/，其中 clash-verge.yaml 是真正下发给内核的合并产物，config.yaml 不是。

安装微信输入法（Ubuntu）

腾讯没有出 Linux 版。社区项目 wetype-ime-linux 把安卓版微信输入法的引擎接进 Fcitx 5：x86_64 上经 QEMU 用户态运行，ARM64 上原生运行。 非官方项目，安装时从腾讯服务器下载 APK 在本机打补丁，本站不托管任何腾讯文件。

用 wetype.sh 一步到位

# 全流程：fcitx -> install -> check
curl -fsSL https://hub.skillnav.dev/wetype.sh | sh -s -- all

# 也可以单独跑某一步
curl -fsSL https://hub.skillnav.dev/wetype.sh | sh -s -- check

子命令	做什么
`fcitx`	只在缺失时装 Fcitx 5 和 GTK/Qt 前端；`~/.xinputrc` 还没选 fcitx5 时跑 `im-config -n fcitx5`，原文件先备份为 `.hub-bak`
`install`	检查 glibc 与 Fcitx 版本，按架构下载 AppImage 装进 `~/.local`，再把 APK 备份到 `~/.local/share/wetype-ime-backup`
`check`	打印 PASS/FAIL/SKIP 体检表，有 FAIL 时退出码为 1

跑完还有两步只能手动：注销重新登录（首次切到 Fcitx 5 必须），然后打开 fcitx5-configtool 添加「微信拼音」，Ctrl+Space 切换。

几个必须知道的前提：

只支持 Ubuntu 24.04 及以上。 预编译插件要求 glibc ≥ 2.38 和 Fcitx 5.1.x，22.04 及更早的版本脚本会停下，需要按上游仓库的 fcitx5-wetype/build.sh 从源码编译插件。
APK 版本锁死 3.5.4。 腾讯哪天下架这个版本的下载地址，在线安装就失效了。脚本装完会把 APK 备份一份，届时离线重装： curl -fsSL https://hub.skillnav.dev/wetype.sh | WETYPE_APK=~/.local/share/wetype-ime-backup/<文件名>.apk sh -s -- install
只有本地词库。 没有账号登录、云端词库和跨设备同步；学习数据在 ~/.local/share/wetype-ime/。
用普通用户跑，不要 sudo。 引擎装在当前用户的 ~/.local 下，apt 那几步脚本会自己调 sudo。

手动排查

fcitx5-diagnose | less                      # Fcitx 5 全面诊断
tail -n 50 /tmp/wetype-harness.log          # 插件日志
APPIMAGE_EXTRACT_AND_RUN=1 ~/.cache/hub-wetype/WeTypeIME-Engine-$(uname -m).AppImage demo nihao   # 命令行测候选

卸载用 AppImage 自带的子命令（保留词库），脚本本身不做卸载：

APPIMAGE_EXTRACT_AND_RUN=1 ~/.cache/hub-wetype/WeTypeIME-Engine-$(uname -m).AppImage uninstall