Native Deployment

💻 Linux、Windows 与 OpenWrt 原生部署

正式 Release 提供 Linux 便携包、Windows 便携包和 OpenWrt APK。下载前先查看最新 Release，并把示例中的 vX.Y.Z 替换为实际版本。

校验下载文件

每个正式 Release 同时提供 SHA256SUMS 和 RELEASE-MANIFEST.json。

Linux：

sha256sum -c SHA256SUMS --ignore-missing

Windows PowerShell：

Get-FileHash .\SubConverter-Extended-vX.Y.Z-windows-amd64.zip -Algorithm SHA256

将输出与 SHA256SUMS 中对应条目比较。校验不一致时不要继续安装。

Linux 便携包

选择架构

uname -m

输出	选择的包
x86_64	linux-amd64.tar.gz
aarch64、arm64	linux-arm64.tar.gz
armv7l、armv7	linux-armv7.tar.gz

解压和启动

VERSION=vX.Y.Z
ARCH=amd64
INSTALL_DIR=/opt/SubConverter-Extended

mkdir -p "$INSTALL_DIR"
tar -xzf "SubConverter-Extended-${VERSION}-linux-${ARCH}.tar.gz" \
  -C "$INSTALL_DIR" \
  --strip-components=1

cd "$INSTALL_DIR"
chmod +x start.sh subconverter
./start.sh

首次启动脚本会在配置缺失时从示例创建 base/pref.toml。如需使用其他配置路径：

PREF_PATH=/etc/subconverter/pref.toml ./start.sh

systemd 示例

[Unit]
Description=SubConverter-Extended
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
WorkingDirectory=/opt/SubConverter-Extended
ExecStart=/opt/SubConverter-Extended/start.sh
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

将文件保存为 /etc/systemd/system/subconverter-extended.service 后：

systemctl daemon-reload
systemctl enable --now subconverter-extended
systemctl status subconverter-extended

查看日志：

journalctl -u subconverter-extended -n 100 --no-pager

便携包内的 update.sh 支持检查、安装、回滚和启动时自动升级。启用方法及长期运行的 systemd Timer 示例见自动升级。

Windows 便携包

1. 下载 SubConverter-Extended-vX.Y.Z-windows-amd64.zip。
2. 校验 SHA-256。
3. 解压到固定目录，例如 C:\SubConverter-Extended。
4. 运行 start.bat，或在 PowerShell 中运行：

Set-Location C:\SubConverter-Extended
.\start.ps1

如果 PowerShell 执行策略阻止脚本：

powershell -ExecutionPolicy Bypass -File .\start.ps1

首次启动按以下顺序查找配置：

1. PREF_PATH 指定的文件；
2. base\pref.toml；
3. base\pref.yml；
4. base\pref.ini；
5. 对应示例文件。

指定其他配置：

$env:PREF_PATH = "D:\subconverter\pref.toml"
& C:\SubConverter-Extended\start.ps1

首次运行出现 Windows 防火墙提示时，只按实际访问范围放行。只在本机使用时，不需要允许不受信任网络访问。

便携包内的 update.ps1 和 update.bat 支持检查、安装、回滚和启动时自动升级。使用方法见自动升级。

OpenWrt APK

APK 适用于使用 apk 包管理器的 OpenWrt 25.12+。Release 中的包未签名，安装时需要 --allow-untrusted。

确认架构：

sed -n '1p' /etc/apk/arch

下载与输出完全匹配的文件，然后安装。不要使用 apk print-arch 选择 ARM APK；该命令可能只返回 aarch64 或 armv7，不是软件包所需的完整 OpenWrt 架构名称。

apk add --allow-untrusted /tmp/SubConverter-Extended-vX.Y.Z-openwrt-ARCH.apk

启动服务：

/etc/init.d/subconverter-extended enable
/etc/init.d/subconverter-extended start

默认配置优先位于：

/etc/subconverter/pref.toml
/etc/subconverter/pref.yml
/etc/subconverter/pref.ini

查看日志：

logread -e subconverter

APK 已集成 LuCI。安装后可在「服务 → SubConverter-Extended」管理主程序，并在「软件更新（Software update）」页面检查、安装、回滚和配置自动升级。页面提供简体中文和英文，并自动跟随 LuCI 的界面语言。详细步骤见自动升级。

Note

OpenWrt 设备的架构、可用存储和网络拓扑各不相同。安装前确认 APK 架构与 /etc/apk/arch 第一行一致，并备份现有配置。

共同成功检查

http://设备地址:25500/version
http://设备地址:25500/healthz

如果其他设备无法访问但本机可以访问，检查监听地址、防火墙、端口发布和网络路由。公网部署继续阅读反向代理与公网部署。