English | 中文

在你的 Linux 服务器上运行以下命令：

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

服务端部署完成后，脚本会输出 短链接 和 Clash 配置。桌面端（Windows/macOS/Linux）请统一使用官方 GUI 客户端：sudoku-desktop。

从 sudoku-desktop Releases 下载对应系统包：

• Windows: sudoku4x4_*_windows-amd64.zip
• macOS Intel: sudoku4x4_*_darwin-amd64.dmg
• macOS Apple Silicon: sudoku4x4_*_darwin-arm64.dmg
• Linux: sudoku4x4_*_linux-amd64.tar.gz

1. 打开客户端，进入 节点 (Nodes) 页面
2. 点击 新增节点 (Add Node)
3. 在 短链接快速导入 区域粘贴 sudoku://...
4. 点击 解析短链接（或直接用 剪贴板一键识别）
5. 点击 保存

1. 选择刚导入的节点并点击 使用
2. 在总览页点击 启动
3. 客户端会负责代理启停（托盘菜单也可 Start Proxy / Stop Proxy）

默认本地端口仍为 127.0.0.1:10233（如你未在节点里修改 localPort）。

• macOS：首次打开若被拦截，先执行以下命令清理隔离属性后再打开：

  xattr -cr "/Applications/sudoku4x4.app"

• macOS / Linux：启用/停止 TUN 时系统可能弹密码框，这是正常行为。

从 GitHub Releases 下载最新 APK 并安装。

💡 如需自行编译，请参考项目的 README。

打开 Sudodroid 后，有以下方式导入节点：

方法一：使用「Quick Import」快捷导入

1. 点击右下角 「+」 浮动按钮
2. 在弹出的对话框顶部找到 「Quick Import」 区域
3. 将 sudoku://... 短链接粘贴到输入框中
4. 点击 「Import Short Link」 按钮
5. 节点会自动导入并被选中

方法二：使用剪贴板粘贴

1. 复制服务端生成的短链接（以 sudoku:// 开头）
2. 打开 Sudodroid，点击 「+」 按钮
3. 在 「sudoku:// link」 输入框右侧点击 📋 粘贴图标
4. 系统会自动从剪贴板读取内容
5. 点击 「Import Short Link」 完成导入

1. 选择一个节点（点击节点卡片）
2. 点击顶部 「Start VPN」 按钮
3. 首次连接会请求 VPN 权限，点击「确定」授权
4. 连接成功后，状态栏会显示 VPN 图标

• ✅ 自动检测系统架构 (amd64/arm64)
• ✅ 从 GitHub Releases 下载最新版本
• ✅ 自动生成密钥对
• ✅ 自动获取服务器公网 IP
• ✅ 创建 systemd 服务（开机自启）
• ✅ 自动部署 Cloudflare 风格 500 错误页回落站（默认 127.0.0.1:10232，失败则回落 127.0.0.1:80）
• ✅ 自动配置 UFW 防火墙（如果启用）
• ✅ 输出短链接和 Clash 节点配置

通过环境变量自定义安装：

# 自定义端口
sudo SUDOKU_PORT=8443 bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# 自定义回落地址
sudo SUDOKU_FALLBACK="127.0.0.1:8080" bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# 关闭 Cloudflare 500 错误页回落站（将不会自动覆盖 SUDOKU_FALLBACK）
sudo SUDOKU_CF_FALLBACK=false bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# 自定义 Cloudflare 500 错误页回落站端口（优先 10232，失败再尝试 80）
sudo SUDOKU_CF_FALLBACK_PORT=10232 SUDOKU_CF_FALLBACK_FALLBACK_PORT=80 bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# 指定短链接/Clash 输出使用的域名或 IP（例如走 CDN 时用域名）
sudo SERVER_IP="example.com" bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# 关闭 HTTP 掩码（直连 TCP）
sudo SUDOKU_HTTP_MASK=false bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# 指定 HTTP 掩码模式（auto / stream / poll / legacy / ws）
sudo SUDOKU_HTTP_MASK_MODE=poll bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# 开启 tunnel 模式 HTTPS（v0.1.4 起不再按端口自动推断 TLS）
sudo SUDOKU_HTTP_MASK_TLS=true bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# HTTP mask/tunnel 路径前缀（一级路径；例如 aabbcc => /aabbcc/session /aabbcc/stream）
sudo SUDOKU_HTTP_MASK_PATH_ROOT=aabbcc bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)" -- --uninstall

再次运行一键命令会自动检测已有安装，仅更新 /usr/local/bin/sudoku 并重启服务，不会覆盖 /etc/sudoku/config.json（如检测到旧版 http_mask_* / disable_http_mask 遗留字段，会自动迁移到 httpmask 结构）。

安装完成后，脚本会输出：

sudoku://eyJoIjoiMS4yLjMuNCIsInAiOjEwMjMzLC...

客户端使用方式： 在桌面 GUI 客户端里导入该 sudoku://... 短链接即可（见上方「桌面 GUI 客户端」步骤）。

# sudoku
- name: sudoku
  type: sudoku
  server: 1.2.3.4
  port: 10233
  key: "你的私钥"
  aead-method: chacha20-poly1305
  padding-min: 2
  padding-max: 7
  custom-table: xpxvvpvv
  table-type: prefer_entropy
	  http-mask: true
	  http-mask-mode: ws
	  http-mask-tls: false
	  http-mask-multiplex: "on"
	  enable-pure-downlink: false

将此配置添加到你的 Clash 配置文件的 proxies 部分。

直接使用一键脚本即可。支持：

• Ubuntu / Debian
• CentOS / RHEL / AlmaLinux
• Alpine Linux

# 查看状态
sudo systemctl status sudoku

# 查看 Cloudflare 500 回落站状态
sudo systemctl status sudoku-fallback

# 重启服务
sudo systemctl restart sudoku

# 查看日志
sudo journalctl -u sudoku -f

# 停止服务
sudo systemctl stop sudoku

Run on your Linux server:

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

After server deployment, the script outputs a short link and Clash config. For desktop use (Windows/macOS/Linux), use the official GUI client: sudoku-desktop.

Download your package from sudoku-desktop Releases:

• Windows: sudoku4x4_*_windows-amd64.zip
• macOS Intel: sudoku4x4_*_darwin-amd64.dmg
• macOS Apple Silicon: sudoku4x4_*_darwin-arm64.dmg
• Linux: sudoku4x4_*_linux-amd64.tar.gz

1. Open the app and go to Nodes
2. Click Add Node
3. Paste sudoku://... in Quick short link import
4. Click Parse short link (or use Parse from clipboard)
5. Click Save

1. Select the imported node and click Use
2. Click Start in Dashboard
3. You can also use tray menu Start Proxy / Stop Proxy

Default local endpoint is still 127.0.0.1:10233 (unless you changed localPort).

• macOS: if app launch is blocked on first run, clear quarantine then open again:

  xattr -cr "/Applications/sudoku4x4.app"

• macOS / Linux: starting/stopping TUN may trigger a password prompt; this is expected.

Download the latest APK from GitHub Releases.

Open Sudodroid and import nodes using one of these methods:

Option 1: Quick Import

1. Tap the "+" floating button (bottom right)
2. Find the "Quick Import" section at the top of the dialog
3. Paste the sudoku://... short link into the input field
4. Tap "Import Short Link" button
5. The node will be imported and selected automatically

Option 2: Clipboard Paste

1. Copy the short link from server (starts with sudoku://)
2. Open Sudodroid, tap "+" button
3. Tap the 📋 paste icon next to the "sudoku:// link" input field
4. The link will be read from clipboard automatically
5. Tap "Import Short Link" to complete

1. Select a node (tap the node card)
2. Tap "Start VPN" button at the top
3. Grant VPN permission when prompted (first time only)
4. VPN icon appears in status bar when connected

• ✅ Auto-detect system architecture (amd64/arm64)
• ✅ Download latest release from GitHub
• ✅ Generate keypair automatically
• ✅ Detect server public IP
• ✅ Create systemd service (auto-start)
• ✅ Deploy Cloudflare-style 500 error fallback page (default 127.0.0.1:10232, falls back to 127.0.0.1:80)
• ✅ Configure UFW firewall (if enabled)
• ✅ Output short link and Clash node config

# Custom port
sudo SUDOKU_PORT=8443 bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# Custom fallback
sudo SUDOKU_FALLBACK="127.0.0.1:8080" bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# Disable Cloudflare 500 fallback page service (will not override SUDOKU_FALLBACK)
sudo SUDOKU_CF_FALLBACK=false bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# Customize Cloudflare 500 fallback page ports (try 10232 first, then 80)
sudo SUDOKU_CF_FALLBACK_PORT=10232 SUDOKU_CF_FALLBACK_FALLBACK_PORT=80 bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# Override advertised host (domain/IP) used in short link & Clash config (use a domain for CDN)
sudo SERVER_IP="example.com" bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# Disable HTTP mask (raw TCP)
sudo SUDOKU_HTTP_MASK=false bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# HTTP mask mode (auto / stream / poll / legacy / ws)
sudo SUDOKU_HTTP_MASK_MODE=poll bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# Enable HTTPS in tunnel modes (since v0.1.4, no port-based TLS inference)
sudo SUDOKU_HTTP_MASK_TLS=true bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

# HTTP mask/tunnel path root (single segment; e.g. aabbcc => /aabbcc/session /aabbcc/stream)
sudo SUDOKU_HTTP_MASK_PATH_ROOT=aabbcc bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)"

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/SUDOKU-ASCII/easy-install/main/install.sh)" -- --uninstall

Re-run the one-click command to update /usr/local/bin/sudoku and restart the service; it will not overwrite /etc/sudoku/config.json (legacy http_mask_* / disable_http_mask fields will be migrated into httpmask automatically if detected).

After installation, the script outputs:

sudoku://eyJoIjoiMS4yLjMuNCIsInAiOjEwMjMzLC...

Client usage: Import this sudoku://... short link in the desktop GUI client (see "Desktop GUI Client" above).

# sudoku
- name: sudoku
  type: sudoku
  server: 1.2.3.4
  port: 10233
  key: "your-private-key"
  aead-method: chacha20-poly1305
  padding-min: 2
  padding-max: 7
  custom-table: xpxvvpvv
  table-type: prefer_entropy
	  http-mask: true
	  http-mask-mode: ws
	  http-mask-tls: false
	  http-mask-multiplex: "on"
	  enable-pure-downlink: false

Add to the proxies section of your Clash config.

Use the one-click script directly. Supports:

• Ubuntu / Debian
• CentOS / RHEL / AlmaLinux
• Alpine Linux

sudo systemctl status sudoku    # Status
sudo systemctl status sudoku-fallback   # CF fallback page status
sudo systemctl restart sudoku   # Restart
sudo journalctl -u sudoku -f    # Logs

GPL-3.0