# sing-box-ohos

**Repository Path**: rymaker/sing-box-ohos

## Basic Information

- **Project Name**: sing-box-ohos
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# sing-box-ohos

![应用图标](entry/src/main/resources/base/media/startIcon.png)

`sing-box-ohos` 是一个运行在 HarmonyOS / OpenHarmony 上的 sing-box 图形化管理客户端，使用 ArkUI 编写界面，并通过原生 NAPI 桥接 sing-box Go 内核。

> 本项目为社区项目，与 sing-box 官方无隶属关系。使用前请确认你的网络用途符合所在地法律法规。

## 功能

- 支持 Mixed 和 TUN 两种运行模式
- 导入完整 sing-box JSON 配置
- 导入 `vmess://`、`vless://`、`ss://`、`trojan://`、`hysteria2://` 分享链接
- 订阅添加、更新和定时自动更新
- 配置管理、节点切换与批量延迟测试
- 概览页实时上下行速率、流量累计和当前节点延迟
- Clash API 实时日志查看
- TUN 参数、DNS、路由、认证和控制面设置
- 深色模式及 HarmonyOS 分层应用图标

## 环境要求

- DevEco Studio，项目当前使用 HarmonyOS SDK `6.1.1(24)`
- 最低兼容 SDK `6.1.0(23)`
- arm64 HarmonyOS 设备
- Git

仓库已经包含预编译的 arm64 sing-box 动态库：

```text
entry/libs/arm64-v8a/libsingbox_ohos.so
```

因此日常开发和打包不需要先编译 Go 内核。若要从源码重新构建内核，请参考 [内核编译指南](doc/sing-box-ohos-kernel-编译指南.md)。

## 获取源码

```bash
git clone https://gitee.com/rymaker/sing-box-ohos.git
cd sing-box-ohos
```

## 构建与运行

1. 使用 DevEco Studio 打开项目根目录。
2. 等待 OHPM 依赖同步完成。
3. 在 `File > Project Structure > Signing Configs` 中配置本机调试签名。
4. 连接 arm64 HarmonyOS 设备。
5. 选择 `entry` 模块并运行。

也可以在配置好 DevEco SDK、JDK 和签名后使用 Hvigor 构建：

```powershell
hvigorw --mode module `
  -p product=default `
  -p module=entry@default `
  -p buildMode=debug `
  assembleHap --no-daemon
```

构建产物位于：

```text
entry/build/default/outputs/default/
```

## 测试

Windows 环境下可执行：

```powershell
./scripts/verify-unit-tests.ps1
```

脚本会运行 ArkTS/Hypium 单元测试及 Go 配置测试。脚本中的 DevEco Studio 安装路径为默认路径，如安装在其他位置，请按实际环境调整。

## 项目结构

```text
AppScope/                  应用级配置、名称和分层图标
core/                      sing-box Go 内核桥接与 OpenHarmony 平台适配
entry/src/main/ets/        ArkTS 业务逻辑与 ArkUI 页面
entry/src/main/cpp/        NAPI 原生桥接层
entry/src/main/resources/  字符串、主题、图标和内置规则集
entry/src/test/            本地单元测试
entry/src/ohosTest/        设备测试
doc/                       设计、编译和验证文档
```

## 说明

- 当前仅提供 arm64 内核库。
- TUN 模式需要用户在系统授权窗口中允许创建 VPN。
- `build-profile.json5` 不包含任何签名材料，克隆后需要配置自己的调试或发布证书。
- `bundleName` 当前为 `com.example.singboxmanage`，正式分发前建议改为你自己的唯一包名。