HI-VPN/LighthouseApp
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 源码提交
Some checks failed
Build Windows / build (push) Has been cancelled
Details

Browse Source
This commit is contained in:
speakeloudest 2025-10-19 23:30:54 -07:00
parent 54e7df78db
commit 75d4c48e41
6076 changed files with 64655 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
.cursorrules Executable file
View File

@ -0,0 +1,74 @@
您精通 Flutter、Dart、Riverpod、Freezed、Flutter Hooks 和 Supabase。
关键原则
- 编写简洁、专业的 Dart 代码，并提供准确的示例。
- 在适当的情况下使用函数式和声明式编程模式。
- 优先使用组合，而非继承。
- 使用带有助动词的描述性变量名（例如 isLoading、hasError）。
- 结构化文件：导出的 Widget、子 Widget、辅助函数、静态内容、类型。
Dart/Flutter
- 对不可变 Widget 使用常量构造函数。
- 利用 Freezed 实现不可变状态类和联合。
- 对简单的函数和方法使用箭头语法。
- 对于单行 getter 和 setter，优先使用表达式主体。
- 使用尾随逗号以获得​​更好的格式和差异显示。
错误处理和验证
- 在视图中使用 SelectableText.rich 而不是 SnackBars 实现错误处理。
- 在 SelectableText.rich 中用红色显示错误以提高可见性。
- 处理显示屏幕内的空状态。
- 使用 AsyncValue 进行正确的错误处理和加载状态。
Riverpod 特定指南
- 使用 @riverpod 注解生成提供程序。
- 优先使用 AsyncNotifierProvider 和 NotifierProvider，而不是 StateProvider。
- 避免使用 StateProvider、StateNotifierProvider 和 ChangeNotifierProvider。
- 使用 ref.invalidate() 手动触发提供程序更新。
- 在处理小部件时，实现正确的异步操作取消机制。
性能优化
- 尽可能使用 const 小部件来优化重建。
- 实现列表视图优化（例如 ListView.builder）。
- 使用 AssetImage 处理静态图片，使用 cached_network_image 处理远程图片。
- 为 Supabase 操作（包括网络错误）实现正确的错误处理。
关键约定
1. 使用 GoRouter 或 auto_route 进行导航和深度链接。
2. 针对 Flutter 性能指标（首次有效绘制、可交互时间）进行优化。
3. 优先使用无状态 Widget：
- 对于状态相关的 Widget，结合使用 ConsumerWidget 和 Riverpod。
- 结合使用 Riverpod 和 Flutter Hooks 时，使用 HookConsumerWidget。
UI 和样式
- 使用 Flutter 内置 Widget 并创建自定义 Widget。
- 使用 LayoutBuilder 或 MediaQuery 实现响应式设计。
- 使用主题背景，确保整个应用的样式一致。
- 使用 Theme.of(context).textTheme.titleLarge 代替 heading6，使用 headingSmall 代替 heading5 等。
模型和数据库约定
- 在数据库表中包含 createdAt、updatedAt 和 isDeleted 字段。
- 对模型使用 @JsonSerializable(fieldRename: FieldRename.snake)。
- 对只读字段实现 @JsonKey(includeFromJson: true, includeToJson: false)。
Widget 和 UI 组件
- 创建小型私有 Widget 类，而不是像 Widget _build.... 这样的函数。
- 实现 RefreshIndicator 以实现下拉刷新功能。
- 在 TextField 中，设置合适的 textCapitalization、keyboardType 和 textInputAction。
- 使用 Image.network 时，务必包含 errorBuilder。
其他
- 使用 log 而不是 print 进行调试。
- 适当时使用 Flutter Hooks / Riverpod Hooks。
- 保持每行不超过 80 个字符，对于多参数函数，请在右括号前添加逗号。
- 使用 @JsonValue(int) 来处理需要访问数据库的枚举。
代码生成
- 使用 build_runner 从注解（Freezed、Riverpod、JSON 序列化）生成代码。
- 修改注解类后，运行“flutter pub run build_runner build --delete-conflicting-outputs”。
文档
- 记录复杂的逻辑和难以理解的代码决策。
- 遵循 Flutter、Riverpod 和 Supabase 官方文档，了解最佳实践。
请参阅 Flutter、Riverpod 和 Supabase 文档，了解 Widget、状态管理和后端集成的最佳实践。

45
.github/workflows/build-windows.yml vendored Executable file
View File

@ -0,0 +1,45 @@
name: Build Windows
on:
push:
branches: [ main, master ]
pull_request:
branches: [ main, master ]
workflow_dispatch:
jobs:
build:
runs-on: windows-latest
steps:
- uses: actions/checkout@v3
- name: Setup Flutter
uses: subosito/flutter-action@v2
with:
flutter-version: '3.24.0'
channel: 'stable'
- name: Enable Windows desktop
run: flutter config --enable-windows-desktop
- name: Get dependencies
run: flutter pub get
- name: Build Windows Debug
run: flutter build windows
- name: Build Windows Release
run: flutter build windows --release
- name: Upload Debug build artifacts
uses: actions/upload-artifact@v3
with:
name: windows-debug-build
path: build/windows/runner/Debug/
- name: Upload Release build artifacts
uses: actions/upload-artifact@v3
with:
name: windows-release-build
path: build/windows/runner/Release/

92
.gitignore vendored Executable file
View File

@ -0,0 +1,92 @@
# Miscellaneous
*.class
*.log
*.pyc
*.swp
.DS_Store
.atom/
.build/
.buildlog/
.history
.svn/
.swiftpm/
migrate_working_dir/
.github/help
# IntelliJ related
*.iml
*.ipr
*.iws
.idea/
# The .vscode folder contains launch configuration and tasks you configure in
# VS Code which you may wish to be included in version control, so this line
# is commented out by default.
#.vscode/
# Flutter/Dart/Pub related
**/doc/api/
**/ios/Flutter/.last_build_id
.dart_tool/
.flutter-plugins
.flutter-plugins-dependencies
.packages
.pub-cache/
.pub/
/build/
# generated files
**/*.g.dart
**/*.freezed.dart
**/*.mapper.dart
**/*.gen.dart
**/*.dll
**/*.dylib
**/*.xcframework
/dist/
/assets/core/*
!/assets/core/.gitkeep
# Symbolication related
app.*.symbols
# Obfuscation related
app.*.map.json
# Android Studio will place build artifacts here
/android/app/debug
/android/app/profile
/android/app/release
/data
/.gradle/
# IDE files
.vs/
.vscode/
# Build artifacts
*.apk
*.aab
*.ipa
*.dmg
*.app
*.exe
# Compiled binaries
*.so
*.dylib
*.dll
# Android artifacts
*.jks
*.keystore
# Certificates
*.cer
*.p12
# Local configuration
local.properties
key.properties

45
.metadata Executable file
View File

@ -0,0 +1,45 @@
# This file tracks properties of this Flutter project.
# Used by Flutter tool to assess capabilities and perform upgrades etc.
#
# This file should be version controlled and should not be manually edited.
version:
revision: "80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819"
channel: "stable"
project_type: app
# Tracks metadata for the flutter migrate command
migration:
platforms:
- platform: root
create_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
base_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
- platform: android
create_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
base_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
- platform: ios
create_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
base_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
- platform: linux
create_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
base_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
- platform: macos
create_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
base_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
- platform: web
create_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
base_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
- platform: windows
create_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
base_revision: 80c2e84975bbd28ecf5f8d4bd4ca5a2490bfc819
# User provided section
# List of Local paths (relative to this file) that should be
# ignored by the migrate tool.
#
# Files that are not part of the templates will be ignored by default.
unmanaged_files:
- 'lib/main.dart'
- 'ios/Runner.xcodeproj/project.pbxproj'

157
ANDROID_LOGIN_PANEL_FIX_SUMMARY.md Executable file
View File

@ -0,0 +1,157 @@
# Android 登录框不显示问题修复总结
## 🔧 修复内容
### **1. KRHomeController 登录状态初始化逻辑修复**
#### **修复前的问题**
- 登录状态初始化没有延迟，可能在异步操作完成前就执行
- 缺少状态验证，直接使用 `kr_isLogin.value` 可能导致状态不一致
- 订阅服务初始化失败时没有错误处理
- 缺少状态同步检查机制
#### **修复后的改进**
```dart
// 1. 添加延迟初始化
Future.delayed(const Duration(milliseconds: 100), () {
_kr_validateAndSetLoginStatus();
});
// 2. 添加状态验证
final isValidLogin = KRAppRunData().kr_token != null &&
KRAppRunData().kr_isLogin.value;
// 3. 添加错误处理
kr_subscribeService.kr_refreshAll().catchError((error) {
KRLogUtil.kr_e('订阅服务初始化失败: $error', tag: 'HomeController');
});
// 4. 添加状态同步检查
WidgetsBinding.instance.addPostFrameCallback((_) {
_kr_syncLoginStatus();
});
```
### **2. KRAppRunData 初始化逻辑优化**
#### **修复前的问题**
- 登录状态设置和异步操作之间存在竞态条件
- 缺少详细的日志记录，难以调试问题
- 错误处理不够完善
#### **修复后的改进**
```dart
// 1. 添加详细日志
KRLogUtil.kr_i('开始初始化用户信息', tag: 'AppRunData');
// 2. 验证token有效性
if (kr_token != null && kr_token!.isNotEmpty) {
kr_isLogin.value = true;
// 异步获取用户信息，不等待结果
_iniUserInfo().catchError((error) {
KRLogUtil.kr_e('获取用户信息失败: $error', tag: 'AppRunData');
});
}
// 3. 改进保存逻辑
// 只有在保存成功后才设置登录状态
kr_isLogin.value = true;
```
### **3. 启动页面保护机制**
#### **修复前的问题**
- 启动完成后立即跳转，没有验证初始化结果
- 缺少启动状态的日志记录
#### **修复后的改进**
```dart
// 1. 添加初始化完成等待
await Future.delayed(const Duration(milliseconds: 200));
// 2. 验证登录状态
final loginStatus = KRAppRunData.getInstance().kr_isLogin.value;
KRLogUtil.kr_i('启动完成，最终登录状态: $loginStatus', tag: 'SplashController');
```
## 🎯 修复效果
### **解决的问题**
1. **竞态条件** - 通过延迟初始化和状态验证解决
2. **状态不一致** - 通过状态同步检查机制解决
3. **异步操作失败** - 通过错误处理和重试机制解决
4. **调试困难** - 通过详细日志记录解决
### **预期改进**
1. **登录框显示稳定性** - 减少启动时登录框不显示的情况
2. **状态一致性** - 确保UI状态与实际登录状态一致
3. **错误恢复能力** - 提高应用在异常情况下的恢复能力
4. **调试便利性** - 通过详细日志便于问题定位
## 📊 修复策略
### **1. 延迟初始化策略**
- 在首页控制器初始化时延迟100ms执行状态验证
- 确保所有异步操作有足够时间完成
### **2. 状态验证策略**
- 双重验证：检查 `kr_token` 和 `kr_isLogin.value`
- 防止状态不一致导致的UI问题
### **3. 错误处理策略**
- 订阅服务初始化失败时不重置登录状态
- 记录错误但不影响用户使用
### **4. 状态同步策略**
- 在UI渲染后检查状态一致性
- 自动修正不一致的状态
## 🧪 测试建议
### **1. 基础功能测试**
- 正常启动测试：连续启动应用10次，观察登录框显示情况
- 登录状态测试：验证已登录和未登录状态的正确显示
### **2. 异常情况测试**
- 网络异常测试：在网络不稳定环境下测试
- 存储异常测试：模拟存储读取失败的情况
- 内存压力测试：在低内存环境下测试
### **3. 边界情况测试**
- 快速重启测试：连续快速重启应用
- 后台恢复测试：应用从后台恢复时的状态检查
## 📝 监控要点
### **1. 关键日志**
- `HomeController` 的登录状态初始化日志
- `AppRunData` 的用户信息初始化日志
- `SplashController` 的启动完成日志
### **2. 状态检查**
- 登录状态与UI状态的一致性
- 订阅服务初始化的成功率
- 应用启动的成功率
## 🔄 后续优化建议
### **1. 短期优化**
- 监控修复效果，收集用户反馈
- 根据实际使用情况调整延迟时间
- 优化错误处理逻辑
### **2. 长期优化**
- 考虑使用状态管理框架（如Riverpod）统一管理状态
- 实现更完善的状态持久化机制
- 添加应用健康检查机制
## ✅ 修复完成
所有修复已完成，包括：
- ✅ KRHomeController 登录状态初始化逻辑修复
- ✅ 状态验证和错误处理添加
- ✅ 状态同步检查机制添加
- ✅ KRAppRunData 初始化逻辑优化
- ✅ 启动页面保护机制添加
修复后的代码应该能显著减少 Android 应用启动时登录框不显示的问题。

241
ANDROID_LOGIN_PANEL_ISSUE_ANALYSIS.md Executable file
View File

@ -0,0 +1,241 @@
# Android 应用启动时登录框不显示问题分析
## 🔍 问题描述
**现象**：Android 应用退出重新打开后，有时会出现无法加载所有功能的情况，具体表现为进入首页后没有显示下面的登录框，需要退出重进多次才能恢复正常。
## 📋 代码逻辑分析
### **1. 应用启动流程**
```dart
// main.dart -> splash -> main
main() -> KRAppRunData().kr_initializeUserInfo() -> Get.offAllNamed(Routes.KR_MAIN)
```
### **2. 登录状态初始化流程**
#### **A. 启动时初始化 (KRAppRunData.kr_initializeUserInfo)**
```dart
Future<void> kr_initializeUserInfo() async {
final String? userInfoString = await KRSecureStorage().kr_readData(key: _keyUserInfo);
if (userInfoString != null) {
// 解析用户信息
kr_token = userInfo['token'];
kr_account = userInfo['account'];
// ...
kr_isLogin.value = kr_token != null; // ⚠️ 关键：设置登录状态
if (kr_isLogin.value) {
await _iniUserInfo(); // 异步获取用户信息
}
}
}
```
#### **B. 首页控制器初始化 (KRHomeController._kr_initLoginStatus)**
```dart
void _kr_initLoginStatus() {
if (KRAppRunData().kr_isLogin.value) {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_loggedIn;
kr_subscribeService.kr_refreshAll(); // ⚠️ 异步刷新订阅数据
} else {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_notLoggedIn;
}
ever(KRAppRunData().kr_isLogin, (isLoggedIn) {
// 监听登录状态变化
});
}
```
### **3. 登录框显示逻辑**
#### **A. 首页视图判断 (KRHomeView.build)**
```dart
Widget build(BuildContext context) {
return Obx(() {
if (controller.kr_currentViewStatus.value == KRHomeViewsStatus.kr_notLoggedIn) {
return Scaffold(
body: Stack(
children: [
const KRHomeMapView(),
Positioned(
bottom: 0,
child: Container(
child: const KRLoginView(), // ⚠️ 登录框在这里显示
),
),
],
),
);
}
// 已登录状态的其他UI...
});
}
```
#### **B. 底部面板判断 (KRHomeBottomPanel._kr_buildDefaultView)**
```dart
Widget _kr_buildDefaultView(BuildContext context) {
final isNotLoggedIn = controller.kr_currentViewStatus.value == KRHomeViewsStatus.kr_notLoggedIn;
if (isNotLoggedIn) {
return SingleChildScrollView(
child: Column(
children: [
const KRHomeConnectionOptionsView(), // ⚠️ 登录选项在这里显示
],
),
);
}
// 已登录状态的其他内容...
}
```
## 🚨 问题根因分析
### **1. 竞态条件 (Race Condition)**
**问题**：`kr_initializeUserInfo()` 中的异步操作可能导致状态不一致
```dart
// 问题代码
kr_isLogin.value = kr_token != null; // 立即设置状态
if (kr_isLogin.value) {
await _iniUserInfo(); // 异步操作，可能失败
}
```
**风险**：
- 如果 `_iniUserInfo()` 失败，登录状态可能不正确
- 网络请求超时或失败时，状态可能不一致
### **2. 异步初始化时序问题**
**问题**：多个异步操作没有正确的依赖关系
```dart
// 启动流程
await KRAppRunData.getInstance().kr_initializeUserInfo(); // 异步1
Get.offAllNamed(Routes.KR_MAIN); // 立即跳转
// 首页初始化
_kr_initLoginStatus(); // 可能此时 kr_isLogin 还未正确设置
```
### **3. 状态监听器初始化时机**
**问题**：`ever()` 监听器可能在状态变化后才注册
```dart
// 可能的问题
kr_isLogin.value = true; // 状态已变化
ever(KRAppRunData().kr_isLogin, (isLoggedIn) { // 监听器注册太晚
// 这个回调可能不会立即触发
});
```
### **4. 订阅服务初始化失败**
**问题**：`kr_subscribeService.kr_refreshAll()` 可能失败
```dart
if (KRAppRunData().kr_isLogin.value) {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_loggedIn;
kr_subscribeService.kr_refreshAll(); // 如果这个失败，UI状态可能不正确
}
```
## 🔧 潜在修复方案
### **1. 添加状态初始化延迟**
```dart
void _kr_initLoginStatus() {
// 延迟初始化，确保所有异步操作完成
Future.delayed(const Duration(milliseconds: 100), () {
if (KRAppRunData().kr_isLogin.value) {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_loggedIn;
} else {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_notLoggedIn;
}
});
}
```
### **2. 添加状态验证**
```dart
void _kr_initLoginStatus() {
// 验证登录状态的有效性
final isValidLogin = KRAppRunData().kr_token != null &&
KRAppRunData().kr_isLogin.value;
if (isValidLogin) {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_loggedIn;
} else {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_notLoggedIn;
}
}
```
### **3. 添加错误处理和重试机制**
```dart
void _kr_initLoginStatus() {
try {
if (KRAppRunData().kr_isLogin.value) {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_loggedIn;
// 添加错误处理
kr_subscribeService.kr_refreshAll().catchError((error) {
KRLogUtil.kr_e('订阅服务初始化失败: $error', tag: 'HomeController');
// 重试或降级处理
});
} else {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_notLoggedIn;
}
} catch (e) {
KRLogUtil.kr_e('登录状态初始化失败: $e', tag: 'HomeController');
kr_currentViewStatus.value = KRHomeViewsStatus.kr_notLoggedIn;
}
}
```
### **4. 添加状态同步检查**
```dart
void _kr_initLoginStatus() {
// 强制同步状态
WidgetsBinding.instance.addPostFrameCallback((_) {
final currentLoginStatus = KRAppRunData().kr_isLogin.value;
if (kr_currentViewStatus.value == KRHomeViewsStatus.kr_loggedIn && !currentLoginStatus) {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_notLoggedIn;
} else if (kr_currentViewStatus.value == KRHomeViewsStatus.kr_notLoggedIn && currentLoginStatus) {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_loggedIn;
}
});
}
```
## 📊 问题影响
1. **用户体验差**：需要多次重启应用才能正常使用
2. **功能不可用**：登录框不显示导致无法登录
3. **状态不一致**：UI状态与实际登录状态不匹配
## 🎯 建议修复优先级
1. **高优先级**：添加状态初始化延迟和验证
2. **中优先级**：添加错误处理和重试机制
3. **低优先级**：优化异步操作时序
## 📝 测试建议
1. **多次重启测试**：连续重启应用 10-20 次，观察登录框显示情况
2. **网络异常测试**：在网络不稳定环境下测试
3. **存储异常测试**：模拟存储读取失败的情况
4. **内存压力测试**：在低内存环境下测试
这个分析为后续的修复提供了明确的方向和具体的实现建议。

87
CONNECTION_DEBUG_SUMMARY.md Executable file
View File

@ -0,0 +1,87 @@
# BearVPN 连接调试总结
## 🔍 问题分析
通过日志分析，发现了节点连接超时的根本原因：
### 核心问题
1. **SingBox URL 测试配置问题**：
- 测试间隔过长：`url-test-interval: 300` (5分钟)
- 测试 URL 可能不稳定：`http://cp.cloudflare.com`
2. **节点延迟值异常**：
- 初始状态：`delay=0` (未测试)
- 测试后：`delay=65535` (超时/失败)
- 反复在 0 和 65535 之间切换
## 🛠️ 解决方案
### 1. 修复 SingBox 配置
```dart
// 修改前
"connection-test-url": "http://cp.cloudflare.com",
"url-test-interval": 300,
// 修改后
"connection-test-url": "http://www.gstatic.com/generate_204",
"url-test-interval": 30,
```
### 2. 添加详细调试信息
- ✅ SingBox 启动过程调试
- ✅ 配置文件保存调试
- ✅ 节点选择过程调试
- ✅ URL 测试过程调试
- ✅ 活动组状态监控
### 3. 优化节点延迟测试
- ✅ 增加详细的连接测试日志
- ✅ 改进错误处理和重试机制
- ✅ 添加测试前后状态对比
## 📊 测试结果
### URL 连通性测试
- ✅ `http://www.gstatic.com/generate_204` - 连接正常
- ✅ `http://cp.cloudflare.com` - 连接正常
- ❌ `http://www.cloudflare.com` - 连接失败
### 预期效果
1. **更快的节点测试**：从 5 分钟间隔改为 30 秒
2. **更稳定的测试 URL**：使用 Google 的连通性测试服务
3. **更详细的调试信息**：便于问题定位和解决
## 🚀 下一步
1. **重新运行应用**：测试修复后的效果
2. **观察日志**：查看新的调试信息
3. **验证节点延迟**：确认延迟值是否正常更新
4. **测试连接稳定性**：验证连接是否稳定
## 📝 调试命令
```bash
# 运行应用并查看日志
flutter run -d macos --debug
# 测试 URL 连通性
./test_url_connectivity.sh
# 基础连接测试
./test_connection.sh
```
## 🔧 关键文件修改
1. `lib/app/services/singbox_imp/kr_sing_box_imp.dart`
- 修复 URL 测试配置
- 添加详细调试信息
- 优化错误处理
2. `lib/app/modules/kr_home/controllers/kr_home_controller.dart`
- 增强节点延迟测试日志
- 改进错误处理机制
3. 新增调试脚本
- `test_connection.sh` - 基础连接测试
- `test_url_connectivity.sh` - URL 连通性测试

202
CONNECTION_INFO_DISAPPEAR_ANALYSIS.md Executable file
View File

@ -0,0 +1,202 @@
# 连接信息消失问题分析
## 🔍 问题描述
用户反馈：在什么情况下，把app关掉后重新打开，下面的"当前连接"和"连接方式"都不显示了。
## 📋 显示逻辑分析
### **1. 当前连接显示条件**
#### **显示位置**: `kr_home_bottom_panel.dart` 第94-97行
```dart
// 1. 如果已订阅，展示当前连接卡片
if (hasValidSubscription)
Container(
margin: EdgeInsets.only(top: 12.h),
child: const KRHomeConnectionInfoView())
```
#### **显示条件**: `hasValidSubscription`
```dart
final hasValidSubscription =
controller.kr_subscribeService.kr_currentSubscribe.value != null;
```
### **2. 连接方式显示条件**
#### **显示位置**: `kr_home_bottom_panel.dart` 第118-123行
```dart
// 4. 连接选项（分组和国家入口）
Padding(
padding: EdgeInsets.symmetric(horizontal: 16.w, vertical: 12.w),
child: const KRHomeConnectionOptionsView(),
),
```
#### **显示条件**: 始终显示（在已登录状态下）
### **3. 登录状态判断**
#### **显示逻辑**: `kr_home_bottom_panel.dart` 第72-85行
```dart
if (isNotLoggedIn)
// 未登录状态下，只显示连接选项
SingleChildScrollView(
child: Column(
children: [
Padding(
padding: EdgeInsets.symmetric(horizontal: 16.w, vertical: 12.w),
child: const KRHomeConnectionOptionsView(),
),
],
),
)
else
// 已登录状态下，显示完整内容
Expanded(
child: SingleChildScrollView(
child: Column(
children: [
// 当前连接卡片（需要hasValidSubscription）
// 连接选项
],
),
),
)
```
## 🎯 问题根源分析
### **核心问题**: `kr_currentSubscribe.value` 为 `null`
当 `kr_currentSubscribe.value` 为 `null` 时：
1. **当前连接卡片不显示**: `hasValidSubscription = false`
2. **连接方式可能不显示**: 取决于登录状态
### **可能导致 `kr_currentSubscribe.value` 为 `null` 的情况**:
#### **1. 订阅服务初始化失败**
- **网络问题**: API请求失败
- **服务器问题**: 后端服务异常
- **超时问题**: 请求超时
#### **2. 订阅数据获取失败**
- **API返回空列表**: `subscribes.isEmpty`
- **订阅过期**: 所有订阅都已过期
- **权限问题**: 用户没有可用订阅
#### **3. 应用启动时序问题**
- **竞态条件**: 订阅服务初始化晚于UI渲染
- **状态同步问题**: 登录状态和订阅状态不同步
- **缓存问题**: 本地缓存数据损坏
#### **4. 登录状态问题**
- **Token失效**: 用户token过期或无效
- **登录状态丢失**: `kr_isLogin.value = false`
- **用户信息加载失败**: 用户信息初始化失败
## 🔧 具体场景分析
### **场景1: 网络问题**
```
启动应用 → 登录成功 → 订阅服务初始化 → 网络请求失败 → kr_currentSubscribe.value = null → 当前连接不显示
```
### **场景2: 订阅过期**
```
启动应用 → 登录成功 → 订阅服务初始化 → 获取订阅列表 → 所有订阅已过期 → kr_currentSubscribe.value = null → 当前连接不显示
```
### **场景3: 竞态条件**
```
启动应用 → UI渲染 → 订阅服务还在初始化中 → kr_currentSubscribe.value = null → 当前连接不显示
```
### **场景4: 登录状态问题**
```
启动应用 → 登录状态判断错误 → 显示未登录界面 → 连接方式显示但当前连接不显示
```
## 📊 调试方法
### **1. 检查关键状态**
```dart
// 在 kr_home_bottom_panel.dart 中添加日志
KRLogUtil.kr_i('当前登录状态: ${controller.kr_currentViewStatus.value}', tag: 'HomeBottomPanel');
KRLogUtil.kr_i('当前订阅: ${controller.kr_subscribeService.kr_currentSubscribe.value}', tag: 'HomeBottomPanel');
KRLogUtil.kr_i('订阅服务状态: ${controller.kr_subscribeService.kr_currentStatus.value}', tag: 'HomeBottomPanel');
```
### **2. 检查订阅服务初始化**
```dart
// 在 kr_subscribe_service.dart 中添加日志
KRLogUtil.kr_i('订阅服务初始化开始', tag: 'SubscribeService');
KRLogUtil.kr_i('获取订阅列表结果: ${subscribes.length} 个订阅', tag: 'SubscribeService');
KRLogUtil.kr_i('当前订阅设置: ${kr_currentSubscribe.value?.name}', tag: 'SubscribeService');
```
### **3. 检查网络请求**
```dart
// 检查API请求是否成功
KRLogUtil.kr_i('API请求状态: ${result.isLeft() ? "失败" : "成功"}', tag: 'SubscribeService');
```
## 🛠️ 修复建议
### **1. 增强错误处理**
```dart
// 在订阅服务初始化失败时，显示错误信息而不是空白
if (kr_currentStatus.value == KRSubscribeServiceStatus.kr_error) {
return _kr_buildErrorView(context);
}
```
### **2. 添加重试机制**
```dart
// 订阅服务初始化失败时自动重试
if (kr_currentSubscribe.value == null && kr_currentStatus.value == KRSubscribeServiceStatus.kr_error) {
// 延迟重试
Future.delayed(Duration(seconds: 3), () {
kr_refreshAll();
});
}
```
### **3. 改善用户体验**
```dart
// 显示加载状态而不是空白
if (kr_currentSubscribe.value == null && kr_currentStatus.value == KRSubscribeServiceStatus.kr_loading) {
return _kr_buildLoadingView();
}
```
### **4. 添加状态检查**
```dart
// 定期检查订阅状态
Timer.periodic(Duration(seconds: 30), (timer) {
if (kr_currentSubscribe.value == null && kr_isLogin.value) {
kr_refreshAll();
}
});
```
## 📝 总结
**问题根源**: `kr_currentSubscribe.value` 为 `null`，导致 `hasValidSubscription = false`
**主要原因**:
1. 订阅服务初始化失败
2. 网络请求失败
3. 订阅数据获取失败
4. 应用启动时序问题
5. 登录状态问题
**解决方案**:
1. 增强错误处理和重试机制
2. 改善用户体验（显示加载状态）
3. 添加状态检查和自动恢复
4. 完善日志记录便于调试
**建议**: 先添加详细的日志记录，确定具体是哪种情况导致的问题，然后针对性地修复。

122
CONNECTION_REFUSED_ISSUE_ANALYSIS.md Executable file
View File

@ -0,0 +1,122 @@
# Connection Refused 问题分析和修复
## 🔍 问题现象
从日志中可以看到所有节点都出现 "Connection refused" 错误：
```
❌ 本机网络测试节点 德国 失败: SocketException: Connection refused (OS Error: Connection refused, errno = 111), address = 156.226.175.116, port = 51036
❌ 本机网络测试节点 美国 失败: SocketException: Connection refused (OS Error: Connection refused, errno = 111), address = 154.29.154.241, port = 59118
❌ 本机网络测试节点 英国 失败: SocketException: Connection refused (OS Error: Connection refused, errno = 111), address = 89.213.40.159, port = 45268
❌ 本机网络测试节点 台湾 失败: SocketException: Connection refused (OS Error: Connection refused, errno = 111), address = 83.147.12.27, port = 49826
❌ 本机网络测试节点 香港 失败: SocketException: Connection refused (OS Error: Connection refused, errno = 111), address = 156.224.78.176, port = 44782
```
## 🎯 问题分析
### **1. 地址解析问题**
#### **问题现象**:
- 所有节点的端口都是随机的大数字（如 51036, 59118, 45268 等）
- 这些端口看起来不像是正常的代理服务端口
#### **根本原因**:
- 原来的代码使用 `Uri.parse(item.serverAddr)` 来解析地址和端口
- 但是 `serverAddr` 可能不包含端口信息，或者解析逻辑有问题
- 端口应该从节点的配置中获取，而不是从 `serverAddr` 中解析
### **2. 配置获取问题**
#### **问题现象**:
- 没有从节点的配置中获取正确的端口号
- 使用了错误的默认端口或解析出的错误端口
#### **根本原因**:
- 节点的端口信息存储在 `item.config['server_port']` 中
- 原来的代码没有正确获取这个配置
## 🔧 修复方案
### **修复内容**:
1. **改进地址解析逻辑**:
```dart
// 从配置中获取正确的地址和端口
String address = item.serverAddr;
int port = 443; // 默认端口
// 如果serverAddr包含端口，先解析
if (item.serverAddr.contains(':')) {
final parts = item.serverAddr.split(':');
if (parts.length == 2) {
address = parts[0];
port = int.tryParse(parts[1]) ?? 443;
}
}
// 从配置中获取端口（优先级更高）
if (item.config != null && item.config['server_port'] != null) {
port = item.config['server_port'];
KRLogUtil.kr_i('📌 从配置获取端口: $port', tag: 'NodeTest');
}
```
2. **增加详细日志**:
```dart
KRLogUtil.kr_i('📋 节点配置: ${item.config}', tag: 'NodeTest');
KRLogUtil.kr_i('📍 最终地址: $address, 端口: $port', tag: 'NodeTest');
```
### **修复逻辑**:
1. **地址处理**:
- 首先使用 `item.serverAddr` 作为地址
- 如果包含端口，则分离地址和端口
- 否则使用默认端口 443
2. **端口获取**:
- 优先从 `item.config['server_port']` 获取端口
- 如果配置中没有端口，使用解析出的端口或默认端口
3. **日志记录**:
- 记录节点配置信息
- 记录最终使用的地址和端口
- 便于调试和问题排查
## 📊 预期效果
### **修复前**:
- 使用错误的端口（如 51036, 59118 等）
- 所有节点连接被拒绝
- 无法获取真实的延迟信息
### **修复后**:
- 使用正确的端口（从配置中获取）
- 能够成功连接到节点
- 获取真实的网络延迟
## 🔍 验证方法
### **1. 检查日志**:
- 查看 `📋 节点配置:` 日志，确认配置信息
- 查看 `📌 从配置获取端口:` 日志，确认端口获取
- 查看 `📍 最终地址:` 日志，确认最终使用的地址和端口
### **2. 测试连接**:
- 确认不再出现 "Connection refused" 错误
- 能够获取到合理的延迟值（通常 < 5000ms）
- 部分节点可能仍然超时，但应该有一些节点能够连接成功
### **3. 端口验证**:
- 确认使用的端口是合理的（如 443, 80, 8080 等）
- 不再使用随机的大数字端口
## 📝 总结
**问题根源**: 地址和端口解析逻辑错误，没有从节点配置中获取正确的端口信息。
**修复方案**: 改进地址解析逻辑，优先从节点配置中获取端口，并增加详细的日志记录。
**预期结果**: 能够使用正确的地址和端口连接节点，获取真实的网络延迟信息。
现在可以重新测试，应该能够看到正确的端口和成功的连接！

184
CRISP_CHAT_FIX_SUMMARY.md Normal file
View File

@ -0,0 +1,184 @@
# Crisp Chat 功能修复总结（支持多平台）
## 问题描述
Crisp 客服聊天功能无法使用，原因是：
1. `crisp_sdk` 包被注释掉（依赖 `flutter_inappwebview` 有问题）
2. 所有 Crisp 相关代码被注释
3. 用户界面显示"客服功能暂时不可用"
4. `crisp_chat` 包只支持 iOS/Android，不支持桌面平台
## 解决方案
### 1. 依赖更新
**文件**: `pubspec.yaml`
- 移除了有问题的 `crisp_sdk` 包
- 添加了 `crisp_chat: ^2.4.1`（使用原生实现，不依赖 `flutter_inappwebview`）
```yaml
crisp_chat: ^2.4.1 # 使用原生实现的 crisp_chat，不依赖 flutter_inappwebview
```
### 2. 控制器重写（支持多平台）
**文件**: `lib/app/modules/kr_crisp_chat/controllers/kr_crisp_controller.dart`
- 完全重写了控制器以支持多平台
- **移动平台（iOS/Android）**:
- 使用 `crisp_chat` 包的原生 API
- 使用 `CrispConfig` 配置 Crisp
- 使用 `FlutterCrispChat.openCrispChat()` 打开聊天窗口
- 使用 `FlutterCrispChat.setSessionString()` 设置会话数据
- **桌面平台（macOS/Windows/Linux）**:
- 使用 WebView 加载 Crisp 官方嵌入脚本
- 动态生成包含 Crisp SDK 的 HTML 页面
- 通过 JavaScript 设置用户信息和会话数据
- 自动打开聊天窗口
**主要改进**:
- ✅ 支持所有平台（iOS、Android、macOS、Windows、Linux）
- ✅ 自动检测平台并选择合适的实现方式
- ✅ 支持用户邮箱和昵称设置
- ✅ 自动收集平台信息
- ✅ 设置语言、应用版本、设备 ID 等会话数据
### 3. 视图重写（多平台支持）
**文件**: `lib/app/modules/kr_crisp_chat/views/kr_crisp_view.dart`
- 移除了占位视图
- **移动平台**: 初始化成功后自动打开 Crisp 原生聊天窗口，窗口关闭后返回
- **桌面平台**: 使用 `webview_flutter` 在应用内显示 Crisp 聊天界面
- 添加了错误处理和重试功能
- 使用 `PopScope` 替代已弃用的 `WillPopScope`
- 移除了 `setBackgroundColor` 调用（macOS 不支持）
### 4. iOS 配置更新
**文件**: `ios/Runner/Info.plist`
添加了 Crisp 所需的权限：
```xml
<key>NSCameraUsageDescription</key>
<string>需要相机权限以支持拍照功能</string>
<key>NSMicrophoneUsageDescription</key>
<string>需要麦克风权限以支持语音消息功能</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要相册权限以支持图片上传功能</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>需要相册添加权限以保存图片</string>
```
### 5. Android 配置
**文件**: `android/app/build.gradle`
- ✅ `compileSdk 36` - 已满足要求（需要 35 或更高）
- ✅ 网络权限已在 `AndroidManifest.xml` 中配置
## 技术细节
### crisp_chat vs crisp_sdk
| 特性 | crisp_chat | crisp_sdk |
|------|-----------|-----------|
| 实现方式 | 原生 SDK | WebView |
| 依赖 | 无额外依赖 | 需要 flutter_inappwebview |
| 性能 | 更好 | 较慢 |
| 兼容性 | 更好 | 依赖问题 |
| 最新版本 | 2.4.1 (2025) | 1.1.0 (2024) |
### API 使用示例
```dart
// 创建配置
final config = CrispConfig(
websiteID: 'your-website-id',
enableNotifications: true,
user: User(
email: 'user@example.com',
nickName: 'User Name',
),
);
// 打开聊天窗口
await FlutterCrispChat.openCrispChat(config: config);
// 设置会话数据
FlutterCrispChat.setSessionString(key: 'platform', value: 'android');
// 重置会话
await FlutterCrispChat.resetCrispChatSession();
```
## 工作流程
1. 用户点击客服按钮
2. 进入 `KRCrispView` 页面
3. `KRCrispController` 初始化：
- 获取用户信息（邮箱/设备ID）
- 创建 `CrispConfig`
- 设置会话数据
4. 初始化完成后自动调用 `openCrispChat()`
5. 显示原生 Crisp 聊天界面
6. 用户关闭聊天后，自动返回上一页
## 测试建议
### 前置条件
1. 确保 `AppConfig.kr_website_id` 配置了有效的 Crisp Website ID
2. 在 Crisp 控制台配置网站设置
### 测试步骤
1. **基础功能测试**
- 打开应用
- 进入"我的"页面
- 点击"客服"按钮
- 验证 Crisp 聊天窗口是否正确打开
2. **用户信息测试**
- 登录用户状态下，验证用户邮箱是否正确传递
- 未登录状态下，验证设备 ID 是否正确使用
3. **会话数据测试**
- 在 Crisp 控制台查看会话数据
- 验证平台、语言、设备 ID 等信息是否正确
4. **权限测试 (iOS)**
- 测试相机权限提示
- 测试麦克风权限提示
- 测试相册权限提示
5. **跨平台测试**
- Android 设备测试
- iOS 设备测试
- Windows/macOS 桌面测试（如果支持）
## 注意事项
1. **Website ID 配置**
- 确保在 `AppConfig` 中配置了正确的 Crisp Website ID
- 可以从 Crisp 控制台获取：Settings → Website Settings → Website ID
2. **推送通知**
- 如需启用推送通知，需要额外配置 Firebase
- 参考 `crisp_chat` 包文档进行配置
3. **语言支持**
- Crisp 支持多语言
- 当前实现会根据应用语言自动设置（zh、zh-tw、en 等）
4. **隐私合规**
- 确保在隐私政策中说明使用 Crisp 客服系统
- 告知用户会话数据的收集和使用
## 相关文件
- `pubspec.yaml` - 依赖配置
- `lib/app/modules/kr_crisp_chat/controllers/kr_crisp_controller.dart` - 控制器
- `lib/app/modules/kr_crisp_chat/views/kr_crisp_view.dart` - 视图
- `lib/app/modules/kr_crisp_chat/bindings/kr_crisp_binding.dart` - 绑定
- `ios/Runner/Info.plist` - iOS 权限配置
- `android/app/build.gradle` - Android 编译配置
## 参考链接
- [crisp_chat 包文档](https://pub.dev/packages/crisp_chat)
- [Crisp 官方文档](https://docs.crisp.chat/)
- [Crisp iOS SDK](https://github.com/crisp-im/crisp-sdk-ios)
- [Crisp Android SDK](https://github.com/crisp-im/crisp-sdk-android)

190
CRISP_MULTI_LANGUAGE_SUPPORT.md Normal file
View File

@ -0,0 +1,190 @@
# Crisp 多语言支持说明
## 🌍 自动语言适配
Crisp 客服聊天**会自动跟随应用的当前语言设置**显示对应的界面！
## 支持的语言
应用支持 7 种语言，Crisp 会自动切换到对应的界面语言：
| 应用语言 | Crisp 显示语言 | 语言代码 |
|---------|--------------|---------|
| 🇬🇧 English | English | `en` |
| 🇨🇳 中文 | 简体中文 | `zh` |
| 🇹🇼 繁體中文 | 繁体中文 | `zh-tw` |
| 🇪🇸 Español | Español | `es` |
| 🇯🇵 日本語 | 日本語 | `ja` |
| 🇷🇺 Русский | Русский | `ru` |
| 🇪🇪 Eesti | Eesti keel | `et` |
## 工作原理
### 1. 获取当前语言
```dart
final currentLanguage = KRLanguageUtils.getCurrentLanguageCode();
```
### 2. 映射到 Crisp Locale
```dart
String _getLocaleForCrisp(String languageCode) {
switch (languageCode) {
case 'zh_CN':
case 'zh':
return 'zh'; // 简体中文
case 'zh_TW':
case 'zhHant':
return 'zh-tw'; // 繁体中文
case 'es':
return 'es'; // 西班牙语
case 'ja':
return 'ja'; // 日语
case 'ru':
return 'ru'; // 俄语
case 'et':
return 'et'; // 爱沙尼亚语
case 'en':
default:
return 'en'; // 英语（默认）
}
}
```
### 3. 初始化 Crisp
```dart
crispController = CrispController(
websiteId: AppConfig.getInstance().kr_website_id,
locale: locale, // 自动设置的语言
);
```
## 用户体验
1. **打开应用** → 应用读取系统语言或用户设置的语言
2. **进入"我的"页面**
3. **点击"客服"按钮**
4. **Crisp 自动以当前应用语言显示界面** ✨
### 示例流程
```
用户系统语言: 简体中文
↓
应用启动，检测语言: zh_CN
↓
用户点击"客服"
↓
Crisp 初始化，locale: 'zh'
↓
显示简体中文界面 🇨🇳
```
如果用户在应用内切换语言：
```
应用设置页面 → 切换语言到 "日本語"
↓
应用重新加载，语言: ja
↓
再次点击"客服"
↓
Crisp 显示日语界面 🇯🇵
```
## 语言切换
用户可以在应用的"设置"页面切换语言：
1. 进入"我的" → "语言切换"
2. 选择想要的语言
3. 应用界面立即切换
4. **下次打开客服，Crisp 也会自动切换到新语言**
## 技术细节
### 代码位置
- **控制器**: `lib/app/modules/kr_crisp_chat/controllers/kr_crisp_controller.dart`
- **语言工具**: `lib/app/localization/kr_language_utils.dart`
### 关键方法
```dart
// 在控制器初始化时调用
Future<void> kr_initializeCrisp() async {
final currentLanguage = KRLanguageUtils.getCurrentLanguageCode();
String locale = _getLocaleForCrisp(currentLanguage);
crispController = CrispController(
websiteId: AppConfig.getInstance().kr_website_id,
locale: locale,
);
}
```
## 扩展支持
如果需要添加新语言支持：
1. **在应用中添加新语言**（`kr_language_utils.dart`）
2. **在 Crisp 控制器中添加映射**（`_getLocaleForCrisp` 方法）
3. **确保 Crisp 支持该语言**（查看 [Crisp 支持的语言列表](https://docs.crisp.chat/guides/chatbox/languages/)）
### 添加新语言示例
假设要添加法语支持：
```dart
// 1. 在 KRLanguage enum 中添加
fr('🇫🇷', 'Français', 'fr')
// 2. 在 _getLocaleForCrisp 中添加映射
case 'fr':
return 'fr'; // 法语
```
## 注意事项
1. **系统语言优先**: 应用会优先使用用户在应用内设置的语言，如果没有设置，则使用系统语言
2. **默认语言**: 如果检测到不支持的语言，默认使用英语（`en`）
3. **实时生效**: 语言切换后，下次打开 Crisp 客服即可看到新语言界面
4. **无需重启**: 切换语言不需要重启应用
## 验证方法
### 测试步骤
1. 打开应用
2. 进入"我的" → "语言切换"
3. 依次选择不同语言
4. 每次选择后，点击"客服"按钮
5. 验证 Crisp 界面语言是否正确切换
### 预期结果
- ✅ 界面文字使用选定的语言
- ✅ 输入框提示文字使用对应语言
- ✅ 系统消息使用对应语言
- ✅ 按钮文字使用对应语言
## 常见问题
### Q: 为什么我切换了语言，Crisp 还是英文？
A: 请确保：
1. 已关闭之前的 Crisp 窗口
2. 重新点击"客服"按钮
3. Crisp 会使用新的语言初始化
### Q: Crisp 支持哪些语言？
A: Crisp 官方支持 30+ 种语言，包括所有主流语言。查看完整列表：https://docs.crisp.chat/guides/chatbox/languages/
### Q: 可以强制使用某个语言吗？
A: 当前实现会自动跟随应用语言。如需强制使用某个语言，可以在初始化时硬编码 locale：
```dart
crispController = CrispController(
websiteId: AppConfig.getInstance().kr_website_id,
locale: 'zh', // 强制使用简体中文
);
```
## 总结
✅ **自动化**: Crisp 完全自动跟随应用语言
✅ **全面支持**: 支持应用所有 7 种语言
✅ **用户友好**: 无需用户手动设置
✅ **实时切换**: 切换语言后立即生效
✅ **可扩展**: 易于添加新语言支持

35
Dockerfile Executable file
View File

@ -0,0 +1,35 @@
FROM ubuntu:latest
# 使用阿里云源
RUN sed -i 's/ports.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list && \
sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list && \
sed -i 's/security.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
# 安装必要的依赖
RUN apt-get update && apt-get install -y \
git \
wget \
unzip \
xz-utils \
zip \
libglu1-mesa \
curl \
sudo \
&& rm -rf /var/lib/apt/lists/*
# 创建非root用户
RUN useradd -ms /bin/bash flutter_user
RUN adduser flutter_user sudo
RUN echo '%sudo ALL=(ALL) NOPASSWD:ALL' >> /etc/sudoers
# 克隆Flutter并设置权限
RUN git clone https://github.com/flutter/flutter.git /flutter && \
chown -R flutter_user:flutter_user /flutter
# 设置环境变量
ENV PATH="/flutter/bin:${PATH}"
# 切换用户并配置Flutter
USER flutter_user
WORKDIR /home/flutter_user
RUN flutter config --enable-windows-desktop

52
Dockerfile.windows Executable file
View File

@ -0,0 +1,52 @@
FROM ubuntu:22.04
# 设置环境变量
ENV DEBIAN_FRONTEND=noninteractive
ENV FLUTTER_VERSION=3.24.0
ENV FLUTTER_HOME=/flutter
ENV PATH=$PATH:$FLUTTER_HOME/bin
# 安装必要的依赖
RUN apt-get update && apt-get install -y \
curl \
git \
unzip \
xz-utils \
zip \
libglu1-mesa \
cmake \
ninja-build \
pkg-config \
libgtk-3-dev \
liblzma-dev \
libstdc++-12-dev \
mingw-w64 \
gcc-mingw-w64 \
g++-mingw-w64 \
&& rm -rf /var/lib/apt/lists/*
# 下载并安装Flutter
RUN cd /tmp && curl -O https://mirrors-i.tuna.tsinghua.edu.cn/flutter/flutter_infra_release/releases/stable/linux/flutter_linux_${FLUTTER_VERSION}-stable.tar.xz \
&& tar xf flutter_linux_${FLUTTER_VERSION}-stable.tar.xz \
&& ls -la \
&& rm -rf /flutter \
&& mv flutter /flutter \
&& rm flutter_linux_${FLUTTER_VERSION}-stable.tar.xz
# 预下载Flutter依赖
RUN flutter precache
# 修复Git权限问题
RUN git config --global --add safe.directory /flutter
# 设置工作目录
WORKDIR /app
# 复制项目文件
COPY . .
# 获取依赖
RUN flutter pub get
# 构建Windows版本
CMD ["flutter", "build", "windows"]

53
Dockerfile.windows-cross Executable file
View File

@ -0,0 +1,53 @@
FROM ubuntu:22.04
# 设置环境变量
ENV DEBIAN_FRONTEND=noninteractive
ENV FLUTTER_VERSION=3.24.0
ENV FLUTTER_HOME=/flutter
ENV PATH=$PATH:$FLUTTER_HOME/bin
# 安装必要的依赖
RUN apt-get update && apt-get install -y \
curl \
git \
unzip \
xz-utils \
zip \
libglu1-mesa \
cmake \
ninja-build \
pkg-config \
libgtk-3-dev \
liblzma-dev \
libstdc++-12-dev \
mingw-w64 \
gcc-mingw-w64 \
g++-mingw-w64 \
wine \
wine64 \
&& rm -rf /var/lib/apt/lists/*
# 下载并安装Flutter
RUN cd /tmp && curl -O https://mirrors-i.tuna.tsinghua.edu.cn/flutter/flutter_infra_release/releases/stable/linux/flutter_linux_${FLUTTER_VERSION}-stable.tar.xz \
&& tar xf flutter_linux_${FLUTTER_VERSION}-stable.tar.xz \
&& rm -rf /flutter \
&& mv flutter /flutter \
&& rm flutter_linux_${FLUTTER_VERSION}-stable.tar.xz
# 预下载Flutter依赖
RUN flutter precache
# 修复Git权限问题
RUN git config --global --add safe.directory /flutter
# 设置工作目录
WORKDIR /app
# 复制项目文件
COPY . .
# 获取依赖
RUN flutter pub get
# 尝试构建Windows版本（使用交叉编译）
CMD ["flutter", "build", "windows", "--release"]

62
INSTALLATION_GUIDE.md Normal file
View File

@ -0,0 +1,62 @@
# BearVPN macOS 安装指南
## 🚨 如果遇到"应用程序无法打开"的问题
### 问题原因
macOS 的安全机制（Gatekeeper）可能会阻止未签名的应用运行。
### 解决方案
#### 方法 1：右键打开（推荐）
1. 右键点击 `BearVPN.app`
2. 选择"打开"
3. 在弹出的对话框中点击"打开"
#### 方法 2：系统偏好设置
1. 打开"系统偏好设置" > "安全性与隐私"
2. 在"通用"标签页中，找到被阻止的应用
3. 点击"仍要打开"
#### 方法 3：终端命令（高级用户）
```bash
# 移除隔离属性
sudo xattr -rd com.apple.quarantine /Applications/BearVPN.app
# 或者完全禁用 Gatekeeper（不推荐）
sudo spctl --master-disable
```
### 验证应用完整性
```bash
# 检查签名状态
codesign -dv --verbose=4 /Applications/BearVPN.app
# 验证签名
codesign --verify --verbose /Applications/BearVPN.app
```
## 📋 系统要求
- macOS 10.15 或更高版本
- 支持 Intel 和 Apple Silicon (M1/M2) 芯片
- 至少 200MB 可用磁盘空间
## 🔧 故障排除
### 如果应用仍然无法打开
1. 确保 macOS 版本符合要求
2. 检查系统时间是否正确
3. 尝试重新下载应用
4. 联系技术支持
### 性能优化
1. 将应用添加到"登录项"以自动启动
2. 在"系统偏好设置"中允许应用访问网络
3. 确保防火墙没有阻止应用
## 📞 技术支持
如果遇到问题，请联系：
- 邮箱：support@bearvpn.com
- 网站：https://bearvpn.com
---
**注意**：本应用已通过 Apple 开发者证书签名，确保安全性和完整性。

183
IOS_BUILD_README.md Normal file
View File

@ -0,0 +1,183 @@
# iOS 自动化构建指南
本指南将帮助您使用自动化脚本构建和签名 iOS 应用，并创建 DMG 安装包。
## 🎯 目标
创建经过签名的 iOS 应用 DMG 文件，用于分发和安装。
## 📋 前提条件
### 1. Apple Developer 账户
- 需要有效的 Apple Developer 账户
- 需要 **iOS Development** 证书
- 需要 **Provisioning Profile**
### 2. 获取证书和配置文件
1. 登录 [Apple Developer Portal](https://developer.apple.com)
2. 进入 "Certificates, Identifiers & Profiles"
3. 创建以下证书：
- **iOS Development** (用于应用签名)
4. 创建 App ID 和 Provisioning Profile
5. 下载并安装证书和配置文件
## 🚀 快速开始
### 步骤 1: 配置签名信息
```bash
# 运行配置脚本
./update_team_id.sh
```
按照提示输入您的 Team ID，脚本会自动更新配置文件。
### 步骤 2: 加载配置
```bash
# 加载签名配置
source ios_signing_config.sh
```
### 步骤 3: 构建 DMG
```bash
# 构建发布版本
./build_ios_dmg.sh
# 或构建调试版本
./build_ios_dmg.sh debug
```
## 📁 输出文件
构建完成后，文件将位于：
```
build/ios/
├── BearVPN-1.0.0.ipa # 签名的 IPA 文件
└── BearVPN-1.0.0-iOS.dmg # DMG 安装包
```
## 🛠️ 可用的构建脚本
### 1. `build_ios_dmg.sh` - 主要构建脚本
- 构建签名的 iOS 应用
- 创建 DMG 安装包
- 支持调试和发布版本
```bash
./build_ios_dmg.sh [debug|release]
```
### 2. `build_ios_simple.sh` - 简化构建脚本
- 构建未签名的版本
- 仅用于测试和开发
```bash
./build_ios_simple.sh [debug|release]
```
### 3. `build_ios_appstore.sh` - App Store 构建脚本
- 构建用于 App Store 分发的版本
- 支持自动上传到 App Store Connect
```bash
./build_ios_appstore.sh [upload|build]
```
## 🔧 配置文件
### `ios_signing_config.sh`
包含所有签名配置信息：
```bash
# Apple Developer 账户信息
export APPLE_ID="your-apple-id@example.com"
export APPLE_PASSWORD="your-app-password"
export TEAM_ID="YOUR_TEAM_ID"
# 应用信息
export APP_NAME="BearVPN"
export BUNDLE_ID="com.bearvpn.app"
export VERSION="1.0.0"
export BUILD_NUMBER="1"
# 签名身份
export SIGNING_IDENTITY="iPhone Developer: Your Name (YOUR_TEAM_ID)"
export DISTRIBUTION_IDENTITY="iPhone Distribution: Your Name (YOUR_TEAM_ID)"
```
## 🔍 验证构建结果
构建完成后，您可以验证结果：
```bash
# 验证 IPA 文件
unzip -l build/ios/BearVPN-1.0.0.ipa
# 验证 DMG 文件
hdiutil verify build/ios/BearVPN-1.0.0-iOS.dmg
# 查看 DMG 内容
hdiutil mount build/ios/BearVPN-1.0.0-iOS.dmg
```
## 🛠️ 故障排除
### 1. 证书问题
```bash
# 查看可用证书
security find-identity -v -p codesigning
# 如果看到 "0 valid identities found"，说明没有安装证书
```
### 2. 配置文件问题
- 确保 Provisioning Profile 已正确安装
- 检查 Bundle ID 是否匹配
- 确保证书和配置文件匹配
### 3. 构建失败
- 检查 Xcode 是否正确安装
- 确保 Flutter 环境正确配置
- 查看构建日志中的具体错误信息
### 4. 签名失败
- 确保证书已正确安装
- 检查签名身份名称是否正确
- 确保证书未过期
## 📚 相关文档
- [Apple 代码签名指南](https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution)
- [Flutter iOS 部署指南](https://docs.flutter.dev/deployment/ios)
- [Xcode 构建指南](https://developer.apple.com/documentation/xcode)
## ⚠️ 重要提醒
1. **安全性**：请妥善保管您的开发者证书和密码
2. **测试**：在分发前，请在真实的 iOS 设备上测试
3. **更新**：定期更新证书，避免过期
4. **备份**：建议备份您的签名配置
## 🎉 成功标志
如果构建成功，您应该看到：
- ✅ 应用构建成功
- ✅ 应用签名成功
- ✅ IPA 文件创建成功
- ✅ DMG 文件创建成功
- ✅ 最终验证通过
## 📞 支持
如果遇到问题，请检查：
1. 构建日志中的错误信息
2. 证书和配置文件是否正确安装
3. 网络连接是否正常
4. Xcode 和 Flutter 版本是否兼容

176
LATENCY_TEST_LOGIC_CONFIRMATION.md Executable file
View File

@ -0,0 +1,176 @@
# 延迟测试逻辑确认
## 🎯 需求确认
**用户需求**:
- **连接代理时**: 保持默认测试规则（使用 SingBox 通过代理测试）
- **没连接时**: 使用本地网络的ping（直接连接节点IP）
## 📋 当前实现逻辑
### **1. 连接状态判断**
#### **连接状态变量**: `kr_isConnected`
```dart
// 是否已连接
final kr_isConnected = false.obs;
```
#### **连接状态更新逻辑**: `_bindConnectionStatus()`
```dart
void _bindConnectionStatus() {
ever(KRSingBoxImp.instance.kr_status, (status) {
switch (status) {
case SingboxStopped():
kr_isConnected.value = false; // 未连接
break;
case SingboxStarting():
kr_isConnected.value = true; // 连接中
break;
case SingboxStarted():
kr_isConnected.value = true; // 已连接
break;
case SingboxStopping():
kr_isConnected.value = false; // 断开中
break;
}
});
}
```
### **2. 延迟测试逻辑**
#### **主测试方法**: `kr_urlTest()`
```dart
Future<void> kr_urlTest() async {
KRLogUtil.kr_i('📊 当前连接状态: ${kr_isConnected.value}', tag: 'HomeController');
if (kr_isConnected.value) {
// ✅ 已连接状态：使用 SingBox 通过代理测试（默认测试规则）
KRLogUtil.kr_i('🔗 已连接状态 - 使用 SingBox 通过代理测试延迟', tag: 'HomeController');
await KRSingBoxImp.instance.kr_urlTest("select");
// 等待 SingBox 完成测试
await Future.delayed(const Duration(seconds: 3));
// 检查活动组状态
final activeGroups = KRSingBoxImp.instance.kr_activeGroups;
// ... 处理测试结果
} else {
// ✅ 未连接状态：使用本机网络直接ping节点IP
KRLogUtil.kr_i('🔌 未连接状态 - 使用本机网络直接ping节点IP测试延迟', tag: 'HomeController');
KRLogUtil.kr_i('🌐 这将绕过代理，直接使用本机网络连接节点', tag: 'HomeController');
await _kr_testLatencyWithoutVpn();
}
}
```
### **3. 本机网络测试逻辑**
#### **本机网络测试方法**: `_kr_testLatencyWithoutVpn()`
```dart
/// 未连接状态下的延迟测试（使用本机网络直接ping节点IP）
Future<void> _kr_testLatencyWithoutVpn() async {
KRLogUtil.kr_i('🔌 开始未连接状态延迟测试（使用本机网络）', tag: 'HomeController');
KRLogUtil.kr_i('🌐 将使用本机网络直接连接节点IP进行延迟测试', tag: 'HomeController');
// 获取所有非auto节点
final testableNodes = kr_subscribeService.allList
.where((item) => item.tag != 'auto')
.toList();
// 并行执行所有测试任务
final testTasks = testableNodes
.map((item) => _kr_testSingleNode(item))
.toList();
await Future.wait(testTasks);
// 统计和显示测试结果
// ...
}
```
#### **单个节点测试方法**: `_kr_testSingleNode()`
```dart
/// 测试单个节点的延迟（使用本机网络直接ping节点IP）
Future<void> _kr_testSingleNode(dynamic item) async {
KRLogUtil.kr_i('🔌 使用本机网络直接连接测试（绕过代理）', tag: 'NodeTest');
// 使用本机网络直接连接测试节点延迟
final socket = await Socket.connect(
address,
port,
timeout: const Duration(seconds: 8), // 8秒超时
);
// 获取延迟时间
final delay = stopwatch.elapsedMilliseconds;
// 设置延迟阈值：超过5秒认为节点不可用
if (delay > 5000) {
item.urlTestDelay.value = 65535; // 标记为不可用
} else {
item.urlTestDelay.value = delay; // 使用本机网络测试的延迟结果
}
}
```
## ✅ 逻辑确认
### **连接代理时（kr_isConnected.value = true）**:
1. **使用默认测试规则**: 调用 `KRSingBoxImp.instance.kr_urlTest("select")`
2. **通过代理测试**: 使用 SingBox 的 URL 测试功能
3. **等待测试完成**: 等待3秒让 SingBox 完成测试
4. **获取测试结果**: 从 `KRSingBoxImp.instance.kr_activeGroups` 获取延迟信息
### **没连接时（kr_isConnected.value = false）**:
1. **使用本机网络**: 调用 `_kr_testLatencyWithoutVpn()`
2. **直接连接节点**: 使用 `Socket.connect()` 直接连接节点IP
3. **绕过代理**: 不经过任何代理，使用本机网络
4. **并行测试**: 同时测试所有节点，提高效率
5. **真实延迟**: 获得本机到节点的真实网络延迟
## 🔍 关键判断点
### **连接状态判断**:
```dart
if (kr_isConnected.value) {
// 连接代理时：使用 SingBox 默认测试规则
} else {
// 没连接时：使用本机网络直接ping节点IP
}
```
### **连接状态来源**:
- `kr_isConnected` 的值来自 `KRSingBoxImp.instance.kr_status`
- 当 SingBox 状态为 `SingboxStarted()` 或 `SingboxStarting()` 时，`kr_isConnected = true`
- 当 SingBox 状态为 `SingboxStopped()` 或 `SingboxStopping()` 时，`kr_isConnected = false`
## 📊 测试验证
### **测试场景1: 连接代理时**
- **预期行为**: 使用 SingBox 通过代理测试
- **验证日志**: `🔗 已连接状态 - 使用 SingBox 通过代理测试延迟`
- **测试方式**: `KRSingBoxImp.instance.kr_urlTest("select")`
### **测试场景2: 没连接时**
- **预期行为**: 使用本机网络直接ping节点IP
- **验证日志**: `🔌 未连接状态 - 使用本机网络直接ping节点IP测试延迟`
- **测试方式**: `Socket.connect()` 直接连接节点
## 📝 总结
**✅ 当前实现完全符合用户需求**:
1. **连接代理时**: 保持默认测试规则，使用 SingBox 通过代理测试延迟
2. **没连接时**: 使用本机网络直接ping节点IP，绕过代理获取真实延迟
**🔧 实现特点**:
- 自动根据连接状态选择测试方式
- 连接时使用代理测试，未连接时使用直连测试
- 详细的日志记录，便于调试和验证
- 并行测试提高效率
- 完善的错误处理和超时机制
**🎯 用户需求已完全实现！**

171
LATENCY_TEST_OPTIMIZATION_SUMMARY.md Executable file
View File

@ -0,0 +1,171 @@
# 延迟测试优化总结
## 🎯 优化目标
解决延迟测试的问题：
- **开启代理后**: 可以正常获取节点的延迟信息
- **不开启代理时**: 无法获取节点延迟，因为网络请求被代理拦截
**解决方案**: 在不开启代理时，使用本机网络直接ping节点IP来获取延迟信息。
## 🔧 优化内容
### **1. 优化延迟测试主逻辑**
#### **修改位置**: `kr_urlTest()` 方法
#### **优化内容**:
- **明确区分测试方式**: 根据连接状态选择不同的测试方法
- **已连接状态**: 使用 SingBox 通过代理测试延迟
- **未连接状态**: 使用本机网络直接ping节点IP测试延迟
```dart
if (kr_isConnected.value) {
// 已连接状态：使用 SingBox 通过代理测试
KRLogUtil.kr_i('🔗 已连接状态 - 使用 SingBox 通过代理测试延迟', tag: 'HomeController');
await KRSingBoxImp.instance.kr_urlTest("select");
} else {
// 未连接状态：使用本机网络直接ping节点IP
KRLogUtil.kr_i('🔌 未连接状态 - 使用本机网络直接ping节点IP测试延迟', tag: 'HomeController');
KRLogUtil.kr_i('🌐 这将绕过代理，直接使用本机网络连接节点', tag: 'HomeController');
await _kr_testLatencyWithoutVpn();
}
```
### **2. 优化未连接状态延迟测试**
#### **修改位置**: `_kr_testLatencyWithoutVpn()` 方法
#### **优化内容**:
- **明确测试方式**: 强调使用本机网络直接连接
- **详细日志记录**: 记录测试过程和结果统计
- **结果展示**: 显示延迟最低的前3个节点
- **错误处理**: 完善的错误处理和统计
```dart
/// 未连接状态下的延迟测试（使用本机网络直接ping节点IP）
Future<void> _kr_testLatencyWithoutVpn() async {
KRLogUtil.kr_i('🔌 开始未连接状态延迟测试（使用本机网络）', tag: 'HomeController');
KRLogUtil.kr_i('🌐 将使用本机网络直接连接节点IP进行延迟测试', tag: 'HomeController');
// 获取所有非auto节点
final testableNodes = kr_subscribeService.allList
.where((item) => item.tag != 'auto')
.toList();
// 并行执行所有测试任务
await Future.wait(testTasks);
// 统计测试结果
final successCount = testableNodes.where((item) => item.urlTestDelay.value < 65535).length;
final failCount = testableNodes.length - successCount;
KRLogUtil.kr_i('📊 测试结果: 成功 $successCount 个，失败 $failCount 个', tag: 'HomeController');
}
```
### **3. 优化单个节点测试方法**
#### **修改位置**: `_kr_testSingleNode()` 方法
#### **优化内容**:
- **明确测试方式**: 强调使用本机网络直接连接（绕过代理）
- **增加超时时间**: 从5秒增加到8秒
- **调整延迟阈值**: 从3秒调整到5秒
- **详细错误分类**: 区分不同类型的连接错误
- **更清晰的日志**: 明确标识使用本机网络测试
```dart
/// 测试单个节点的延迟（使用本机网络直接ping节点IP）
Future<void> _kr_testSingleNode(dynamic item) async {
KRLogUtil.kr_i('🔌 使用本机网络直接连接测试（绕过代理）', tag: 'NodeTest');
// 创建Socket连接，使用本机网络（不经过代理）
final socket = await Socket.connect(
address,
port,
timeout: const Duration(seconds: 8), // 增加超时时间到8秒
);
// 设置延迟阈值：超过5秒认为节点不可用
if (delay > 5000) {
item.urlTestDelay.value = 65535;
KRLogUtil.kr_w('⚠️ 节点 ${item.tag} 延迟过高: ${delay}ms，标记为不可用', tag: 'NodeTest');
} else {
// 使用本机网络测试的延迟结果
item.urlTestDelay.value = delay;
KRLogUtil.kr_i('✅ 节点 ${item.tag} 本机网络延迟测试成功: ${delay}ms', tag: 'NodeTest');
}
}
```
## 🎯 优化效果
### **解决的问题**:
1. **代理拦截问题**: 未连接时使用本机网络直接连接，绕过代理拦截
2. **延迟测试不准确**: 使用本机网络直接ping节点IP，获得真实的网络延迟
3. **测试方式不明确**: 明确区分代理测试和直连测试
4. **错误处理不完善**: 增加详细的错误分类和处理
### **预期改善**:
1. **未连接状态**: 可以正常获取节点延迟信息
2. **测试准确性**: 使用本机网络测试，获得更准确的延迟数据
3. **用户体验**: 无论是否连接代理，都能看到节点延迟
4. **调试能力**: 详细的日志记录，便于问题排查
## 📊 测试场景
### **测试场景1: 未连接状态延迟测试**
- **预期行为**: 使用本机网络直接连接节点IP
- **验证要点**:
- 日志显示"使用本机网络直接连接测试（绕过代理）"
- 能够获取到节点的真实延迟
- 延迟值合理（通常 < 5000ms）
### **测试场景2: 已连接状态延迟测试**
- **预期行为**: 使用 SingBox 通过代理测试
- **验证要点**:
- 日志显示"使用 SingBox 通过代理测试延迟"
- 通过代理获取延迟信息
- 测试结果正确显示
### **测试场景3: 网络异常处理**
- **预期行为**: 正确处理连接超时、拒绝、不可达等情况
- **验证要点**:
- 超时节点标记为不可用（65535）
- 错误日志详细记录错误类型
- 测试继续进行，不影响其他节点
## 🔍 关键日志点
### **测试开始**:
- `🔌 开始未连接状态延迟测试（使用本机网络）`
- `🌐 将使用本机网络直接连接节点IP进行延迟测试`
### **单个节点测试**:
- `🔌 使用本机网络直接连接测试（绕过代理）`
- `⏱️ 本机网络连接延迟: XXXms`
- `✅ 节点 XXX 本机网络延迟测试成功: XXXms`
### **测试结果**:
- `📊 测试结果: 成功 X 个，失败 X 个`
- `🏆 延迟最低的前3个节点:`
### **错误处理**:
- `⏰ 节点 XXX 连接超时`
- `🚫 节点 XXX 连接被拒绝`
- `🌐 节点 XXX 网络不可达`
## 📝 总结
通过这次优化，我们解决了延迟测试的核心问题：
1. **明确区分测试方式**: 根据连接状态选择代理测试或直连测试
2. **使用本机网络**: 未连接时直接ping节点IP，绕过代理拦截
3. **提高测试准确性**: 获得真实的网络延迟数据
4. **完善错误处理**: 详细的错误分类和日志记录
5. **改善用户体验**: 无论是否连接代理，都能看到节点延迟
现在用户可以在未连接代理的情况下，通过本机网络直接测试节点延迟，获得准确的延迟信息！

285
LOGIN_MAP_ONLY_ISSUE_ANALYSIS.md Executable file
View File

@ -0,0 +1,285 @@
# 登录后只显示地图问题分析
## 🔍 问题描述
用户反馈：登录后，有时候重新打开app会直接只加载地图，其他的页面（底部面板、登录框等）就没有正常显示。
## 📋 问题分析
### **1. 页面显示逻辑分析**
#### **首页视图显示逻辑** (`kr_home_view.dart`)
```dart
// 根据登录状态决定显示内容
if (controller.kr_currentViewStatus.value == KRHomeViewsStatus.kr_notLoggedIn) {
// 未登录：显示地图 + 登录框
return Scaffold(
body: Stack(
children: [
const KRHomeMapView(), // 地图视图
Positioned(bottom: 0, child: KRLoginView()), // 登录框
],
),
);
}
// 已登录：显示地图 + 底部面板
return Scaffold(
body: Stack(
children: [
const KRHomeMapView(), // 地图视图
Positioned(bottom: 0, child: KRHomeBottomPanel()), // 底部面板
],
),
);
```
#### **底部面板显示逻辑** (`kr_home_bottom_panel.dart`)
```dart
// 根据订阅服务状态决定显示内容
if (controller.kr_currentListStatus.value == KRHomeViewsListStatus.kr_loading) {
return _kr_buildLoadingView(); // 显示加载动画
}
if (controller.kr_currentListStatus.value == KRHomeViewsListStatus.kr_error) {
return _kr_buildErrorView(context); // 显示错误信息
}
// 正常状态：显示订阅信息、连接选项等
return _kr_buildDefaultView(context);
```
### **2. 状态初始化流程**
#### **启动流程**
1. **启动页面** (`kr_splash_controller.dart`)
- 初始化 SingBox
- 初始化用户信息 (`KRAppRunData.getInstance().kr_initializeUserInfo()`)
- 跳转到主页面
2. **主页面初始化** (`kr_main_controller.dart`)
- 创建首页控制器 (`KRHomeController`)
- 显示首页视图 (`KRHomeView`)
3. **首页控制器初始化** (`kr_home_controller.dart`)
- `_kr_initLoginStatus()` - 初始化登录状态
- `_bindSubscribeStatus()` - 绑定订阅状态
- `_bindConnectionStatus()` - 绑定连接状态
#### **登录状态初始化** (`_kr_initLoginStatus`)
```dart
void _kr_initLoginStatus() {
// 延迟100ms初始化，确保异步操作完成
Future.delayed(const Duration(milliseconds: 100), () {
_kr_validateAndSetLoginStatus();
});
// 注册登录状态监听器
ever(KRAppRunData().kr_isLogin, (isLoggedIn) {
_kr_handleLoginStatusChange(isLoggedIn);
});
}
```
#### **订阅状态绑定** (`_bindSubscribeStatus`)
```dart
void _bindSubscribeStatus() {
ever(kr_subscribeService.kr_currentStatus, (data) {
if (KRAppRunData.getInstance().kr_isLogin.value) {
if (data == KRSubscribeServiceStatus.kr_loading) {
kr_currentListStatus.value = KRHomeViewsListStatus.kr_loading;
} else if (data == KRSubscribeServiceStatus.kr_error) {
kr_currentListStatus.value = KRHomeViewsListStatus.kr_error;
} else {
kr_currentListStatus.value = KRHomeViewsListStatus.kr_none;
}
}
});
}
```
### **3. 潜在问题点**
#### **问题1: 竞态条件 (Race Condition)**
- **现象**: 登录状态和订阅服务状态初始化时序不确定
- **原因**:
- `_kr_initLoginStatus()` 延迟100ms执行
- `kr_subscribeService.kr_refreshAll()` 异步执行
- 两个异步操作可能产生竞态条件
#### **问题2: 订阅服务初始化失败**
- **现象**: 订阅服务状态卡在 `kr_loading` 或 `kr_error`
- **原因**:
- 网络请求失败
- API 响应异常
- 数据解析错误
- 超时问题
#### **问题3: 状态监听器注册时机**
- **现象**: 状态变化时监听器未正确响应
- **原因**:
- 监听器注册在异步操作之后
- 状态变化发生在监听器注册之前
#### **问题4: 登录状态验证逻辑**
- **现象**: 登录状态判断不准确
- **原因**:
- Token 验证逻辑复杂
- 状态同步检查可能失败
### **4. 具体场景分析**
#### **场景1: 只显示地图，无底部面板**
```
可能原因：
1. kr_currentViewStatus = kr_loggedIn (已登录)
2. kr_currentListStatus = kr_loading (订阅服务加载中)
3. 订阅服务初始化失败或超时
4. 底部面板显示加载动画，但加载动画可能有问题
```
#### **场景2: 显示地图 + 登录框（应该是已登录状态）**
```
可能原因：
1. kr_currentViewStatus = kr_notLoggedIn (未登录)
2. 登录状态验证失败
3. Token 无效或过期
4. 状态同步检查失败
```
#### **场景3: 显示地图 + 错误信息**
```
可能原因：
1. kr_currentViewStatus = kr_loggedIn (已登录)
2. kr_currentListStatus = kr_error (订阅服务错误)
3. 网络请求失败
4. API 返回错误
```
## 🛠️ 修复建议
### **1. 增强状态验证**
```dart
void _kr_validateAndSetLoginStatus() {
try {
// 多重验证登录状态
final hasToken = KRAppRunData().kr_token != null && KRAppRunData().kr_token!.isNotEmpty;
final isLoginFlag = KRAppRunData().kr_isLogin.value;
final isValidLogin = hasToken && isLoginFlag;
KRLogUtil.kr_i('登录状态验证: hasToken=$hasToken, isLogin=$isLoginFlag, isValid=$isValidLogin', tag: 'HomeController');
if (isValidLogin) {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_loggedIn;
// 确保订阅服务初始化
_kr_ensureSubscribeServiceInitialized();
} else {
kr_currentViewStatus.value = KRHomeViewsStatus.kr_notLoggedIn;
}
} catch (e) {
KRLogUtil.kr_e('登录状态验证失败: $e', tag: 'HomeController');
kr_currentViewStatus.value = KRHomeViewsStatus.kr_notLoggedIn;
}
}
```
### **2. 确保订阅服务初始化**
```dart
void _kr_ensureSubscribeServiceInitialized() {
// 检查订阅服务状态
if (kr_subscribeService.kr_currentStatus.value == KRSubscribeServiceStatus.kr_none) {
KRLogUtil.kr_i('订阅服务未初始化，开始初始化', tag: 'HomeController');
kr_subscribeService.kr_refreshAll().catchError((error) {
KRLogUtil.kr_e('订阅服务初始化失败: $error', tag: 'HomeController');
// 设置错误状态
kr_currentListStatus.value = KRHomeViewsListStatus.kr_error;
});
}
}
```
### **3. 添加超时处理**
```dart
void _kr_initLoginStatus() {
// 设置超时处理
Timer(const Duration(seconds: 10), () {
if (kr_currentListStatus.value == KRHomeViewsListStatus.kr_loading) {
KRLogUtil.kr_w('订阅服务初始化超时', tag: 'HomeController');
kr_currentListStatus.value = KRHomeViewsListStatus.kr_error;
}
});
// 延迟初始化
Future.delayed(const Duration(milliseconds: 100), () {
_kr_validateAndSetLoginStatus();
});
}
```
### **4. 增强错误处理**
```dart
void _bindSubscribeStatus() {
ever(kr_subscribeService.kr_currentStatus, (data) {
if (KRAppRunData.getInstance().kr_isLogin.value) {
switch (data) {
case KRSubscribeServiceStatus.kr_loading:
kr_currentListStatus.value = KRHomeViewsListStatus.kr_loading;
break;
case KRSubscribeServiceStatus.kr_error:
kr_currentListStatus.value = KRHomeViewsListStatus.kr_error;
// 添加重试机制
_kr_retrySubscribeService();
break;
case KRSubscribeServiceStatus.kr_success:
kr_currentListStatus.value = KRHomeViewsListStatus.kr_none;
break;
default:
kr_currentListStatus.value = KRHomeViewsListStatus.kr_none;
}
}
});
}
```
### **5. 添加重试机制**
```dart
void _kr_retrySubscribeService() {
Timer(const Duration(seconds: 3), () {
if (kr_currentListStatus.value == KRHomeViewsListStatus.kr_error) {
KRLogUtil.kr_i('重试订阅服务初始化', tag: 'HomeController');
kr_subscribeService.kr_refreshAll().catchError((error) {
KRLogUtil.kr_e('重试失败: $error', tag: 'HomeController');
});
}
});
}
```
## 📊 监控和调试
### **1. 关键日志点**
- 登录状态验证日志
- 订阅服务初始化日志
- 状态变化日志
- 错误处理日志
### **2. 状态检查**
- `kr_currentViewStatus` 的值
- `kr_currentListStatus` 的值
- `kr_subscribeService.kr_currentStatus` 的值
- `KRAppRunData().kr_isLogin` 的值
### **3. 网络状态**
- API 请求是否成功
- 响应数据是否正常
- 超时情况
## 🎯 总结
这个问题主要是由于**异步初始化时序问题**和**状态管理复杂性**导致的。核心问题是：
1. **登录状态验证** 和 **订阅服务初始化** 之间存在竞态条件
2. **订阅服务初始化失败** 时没有合适的错误处理和重试机制
3. **状态监听器注册时机** 可能晚于状态变化
通过增强状态验证、添加超时处理、完善错误处理和重试机制，可以显著改善这个问题的发生频率。

218
LOGIN_MAP_ONLY_ISSUE_FIX_SUMMARY.md Executable file
View File

@ -0,0 +1,218 @@
# 登录后只显示地图问题修复总结
## 🎯 修复目标
解决登录后重新打开app时只显示地图而其他页面（底部面板、登录框等）不显示的问题。
## 🔧 修复内容
### **1. 增强登录状态验证逻辑**
#### **修改位置**: `_kr_validateAndSetLoginStatus()` 方法
#### **修复内容**:
- **多重验证**: 同时检查 `hasToken` 和 `isLoginFlag`
- **详细日志**: 添加更详细的状态验证日志
- **Token验证**: 确保Token不为空且不为空字符串
- **状态设置**: 明确设置登录状态并记录日志
```dart
// 多重验证登录状态
final hasToken = KRAppRunData().kr_token != null && KRAppRunData().kr_token!.isNotEmpty;
final isLoginFlag = KRAppRunData().kr_isLogin.value;
final isValidLogin = hasToken && isLoginFlag;
KRLogUtil.kr_i('登录状态验证: hasToken=$hasToken, isLogin=$isLoginFlag, isValid=$isValidLogin', tag: 'HomeController');
KRLogUtil.kr_i('Token内容: ${KRAppRunData().kr_token?.substring(0, 10)}...', tag: 'HomeController');
```
### **2. 确保订阅服务初始化**
#### **新增方法**: `_kr_ensureSubscribeServiceInitialized()`
#### **修复内容**:
- **状态检查**: 检查订阅服务当前状态
- **智能初始化**: 根据状态决定是否需要初始化
- **错误处理**: 初始化失败时设置错误状态
- **自动重试**: 失败时自动启动重试机制
```dart
void _kr_ensureSubscribeServiceInitialized() {
try {
// 检查订阅服务状态
final currentStatus = kr_subscribeService.kr_currentStatus.value;
if (currentStatus == KRSubscribeServiceStatus.kr_none ||
currentStatus == KRSubscribeServiceStatus.kr_error) {
// 设置加载状态并初始化
kr_currentListStatus.value = KRHomeViewsListStatus.kr_loading;
kr_subscribeService.kr_refreshAll().then((_) {
KRLogUtil.kr_i('订阅服务初始化完成', tag: 'HomeController');
}).catchError((error) {
KRLogUtil.kr_e('订阅服务初始化失败: $error', tag: 'HomeController');
kr_currentListStatus.value = KRHomeViewsListStatus.kr_error;
_kr_retrySubscribeService();
});
}
} catch (e) {
KRLogUtil.kr_e('确保订阅服务初始化失败: $e', tag: 'HomeController');
kr_currentListStatus.value = KRHomeViewsListStatus.kr_error;
}
}
```
### **3. 添加超时处理机制**
#### **修改位置**: `_kr_initLoginStatus()` 方法
#### **修复内容**:
- **超时检测**: 10秒后检查订阅服务是否还在加载
- **自动处理**: 超时时自动设置为错误状态
- **重试机制**: 超时后自动启动重试
```dart
// 设置超时处理
Timer(const Duration(seconds: 10), () {
if (kr_currentListStatus.value == KRHomeViewsListStatus.kr_loading) {
KRLogUtil.kr_w('订阅服务初始化超时，设置为错误状态', tag: 'HomeController');
kr_currentListStatus.value = KRHomeViewsListStatus.kr_error;
_kr_retrySubscribeService();
}
});
```
### **4. 增强错误处理和重试机制**
#### **新增方法**: `_kr_retrySubscribeService()`
#### **修复内容**:
- **智能重试**: 3秒后自动重试
- **多次重试**: 最多重试3次
- **渐进延迟**: 重试间隔逐渐增加
- **状态检查**: 只在错误状态时重试
```dart
void _kr_retrySubscribeService() {
KRLogUtil.kr_i('启动订阅服务重试机制', tag: 'HomeController');
Timer(const Duration(seconds: 3), () {
if (kr_currentListStatus.value == KRHomeViewsListStatus.kr_error) {
KRLogUtil.kr_i('重试订阅服务初始化', tag: 'HomeController');
kr_subscribeService.kr_refreshAll().then((_) {
KRLogUtil.kr_i('订阅服务重试成功', tag: 'HomeController');
}).catchError((error) {
KRLogUtil.kr_e('订阅服务重试失败: $error', tag: 'HomeController');
// 第二次重试
Timer(const Duration(seconds: 5), () {
if (kr_currentListStatus.value == KRHomeViewsListStatus.kr_error) {
KRLogUtil.kr_i('第二次重试订阅服务初始化', tag: 'HomeController');
kr_subscribeService.kr_refreshAll().catchError((error) {
KRLogUtil.kr_e('第二次重试失败: $error', tag: 'HomeController');
});
}
});
});
}
});
}
```
### **5. 优化异步初始化时序**
#### **修改位置**: `_bindSubscribeStatus()` 方法
#### **修复内容**:
- **状态监听**: 增强订阅服务状态监听
- **智能处理**: 根据状态自动处理不同情况
- **自动初始化**: 状态为none时自动尝试初始化
- **详细日志**: 添加详细的状态变化日志
```dart
void _bindSubscribeStatus() {
ever(kr_subscribeService.kr_currentStatus, (data) {
KRLogUtil.kr_i('订阅服务状态变化: $data', tag: 'HomeController');
if (KRAppRunData.getInstance().kr_isLogin.value) {
switch (data) {
case KRSubscribeServiceStatus.kr_loading:
kr_currentListStatus.value = KRHomeViewsListStatus.kr_loading;
break;
case KRSubscribeServiceStatus.kr_error:
kr_currentListStatus.value = KRHomeViewsListStatus.kr_error;
_kr_retrySubscribeService();
break;
case KRSubscribeServiceStatus.kr_success:
kr_currentListStatus.value = KRHomeViewsListStatus.kr_none;
break;
case KRSubscribeServiceStatus.kr_none:
// 如果状态为none且已登录，尝试初始化
if (kr_currentViewStatus.value == KRHomeViewsStatus.kr_loggedIn) {
_kr_ensureSubscribeServiceInitialized();
}
break;
}
}
});
}
```
## 🎯 修复效果
### **解决的问题**:
1. **竞态条件**: 通过增强状态验证和确保订阅服务初始化解决
2. **订阅服务初始化失败**: 通过添加重试机制和超时处理解决
3. **状态监听器注册时机**: 通过优化异步初始化时序解决
4. **登录状态验证不准确**: 通过多重验证和详细日志解决
### **预期改善**:
1. **减少只显示地图的情况**: 通过确保订阅服务正确初始化
2. **提高状态一致性**: 通过增强状态验证和同步检查
3. **增强错误恢复能力**: 通过自动重试机制
4. **改善用户体验**: 通过超时处理和智能重试
## 📊 监控和调试
### **关键日志点**:
- `登录状态验证: hasToken=xxx, isLogin=xxx, isValid=xxx`
- `订阅服务当前状态: xxx`
- `订阅服务状态变化: xxx`
- `启动订阅服务重试机制`
- `订阅服务初始化超时`
### **状态检查**:
- `kr_currentViewStatus` 的值
- `kr_currentListStatus` 的值
- `kr_subscribeService.kr_currentStatus` 的值
- `KRAppRunData().kr_isLogin` 的值
## 🚀 测试建议
### **测试场景**:
1. **正常登录**: 验证登录后所有功能正常显示
2. **网络异常**: 验证网络异常时的重试机制
3. **超时情况**: 验证超时处理和自动重试
4. **状态切换**: 验证登录/登出状态切换
5. **多次重试**: 验证多次重试后的最终状态
### **验证要点**:
- 登录后底部面板是否正常显示
- 订阅服务是否成功初始化
- 错误状态是否自动恢复
- 重试机制是否正常工作
- 日志信息是否详细准确
## 📝 总结
通过系统性的修复，我们解决了登录后只显示地图问题的根本原因：
1. **增强了状态验证的可靠性**
2. **确保了订阅服务的正确初始化**
3. **添加了超时处理和重试机制**
4. **优化了异步初始化的时序**
5. **完善了错误处理和恢复逻辑**
这些修复将显著减少问题的发生频率，提高应用的稳定性和用户体验。

126
MACOS_BUILD_README.md Normal file
View File

@ -0,0 +1,126 @@
# macOS DMG 构建指南
本指南将帮助您构建 macOS DMG 安装包，并避免用户在安装时需要在安全隐私设置中手动允许。
## 🎯 目标
构建一个经过代码签名和公证的 DMG 安装包，用户安装时无需手动允许。
## 📋 前提条件
### 1. Apple Developer 账户
- 需要有效的 Apple Developer 账户（$99/年）
- 需要 **Developer ID Application** 证书
- 需要 **Developer ID Installer** 证书
### 2. 获取证书
1. 登录 [Apple Developer Portal](https://developer.apple.com)
2. 进入 "Certificates, Identifiers & Profiles"
3. 创建以下证书：
- **Developer ID Application** (用于应用签名)
- **Developer ID Installer** (用于安装包签名)
### 3. 创建 App 专用密码
1. 登录 [Apple ID 管理页面](https://appleid.apple.com)
2. 在 "App 专用密码" 部分创建新密码
3. 记录此密码，稍后需要用到
## 🚀 构建步骤
### 方法一：完整签名版本（推荐）
1. **配置签名信息**
```bash
# 编辑配置文件
nano macos_signing_config.sh
# 修改以下信息：
export APPLE_ID="your-apple-id@example.com"
export APPLE_PASSWORD="your-app-specific-password"
export TEAM_ID="YOUR_TEAM_ID"
export SIGNING_IDENTITY="Developer ID Application: Your Name (YOUR_TEAM_ID)"
```
2. **加载配置并构建**
```bash
# 加载配置
source macos_signing_config.sh
# 构建 DMG
./build_macos_dmg.sh
```
### 方法二：简化版本（需要手动允许）
如果您没有开发者证书，可以使用简化版本：
```bash
./build_macos_simple.sh
```
**注意**：此版本需要用户在安装时手动在安全隐私设置中允许。
## 📁 输出文件
构建完成后，DMG 文件将位于：
```
build/macos/Build/Products/Release/kaer_with_panels.dmg
```
## 🔍 验证签名
构建完成后，您可以验证签名：
```bash
# 验证应用签名
codesign --verify --verbose build/macos/Build/Products/Release/kaer_with_panels.app
# 验证 DMG 签名
codesign --verify --verbose build/macos/Build/Products/Release/kaer_with_panels.dmg
# 检查公证状态
spctl --assess --verbose build/macos/Build/Products/Release/kaer_with_panels.dmg
```
## 🛠️ 故障排除
### 1. 证书问题
```bash
# 查看可用证书
security find-identity -v -p codesigning
# 如果看到 "0 valid identities found"，说明没有安装证书
```
### 2. 公证失败
- 确保 Apple ID 和密码正确
- 确保 Team ID 正确
- 检查网络连接
### 3. 签名失败
- 确保证书已正确安装
- 检查签名身份名称是否正确
- 确保证书未过期
## 📚 相关文档
- [Apple 代码签名指南](https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution)
- [Flutter macOS 部署指南](https://docs.flutter.dev/deployment/macos)
- [DMG 创建指南](https://developer.apple.com/design/human-interface-guidelines/macos/windows-and-views/dialogs/)
## ⚠️ 重要提醒
1. **安全性**：请妥善保管您的开发者证书和密码
2. **测试**：在分发前，请在干净的 macOS 系统上测试安装
3. **更新**：定期更新证书，避免过期
4. **备份**：建议备份您的签名配置
## 🎉 成功标志
如果构建成功，您应该看到：
- ✅ 应用签名成功
- ✅ DMG 签名成功
- ✅ DMG 公证成功
- ✅ 最终验证通过
用户安装时应该能够直接运行，无需手动允许。

241
Makefile Executable file
View File

@ -0,0 +1,241 @@
# .ONESHELL:
include dependencies.properties
MKDIR := mkdir -p
RM := rm -rf
SEP :=/
ifeq ($(OS),Windows_NT)
ifeq ($(IS_GITHUB_ACTIONS),)
MKDIR := -mkdir
RM := rmdir /s /q
SEP:=\\
endif
endif
BINDIR=libcore$(SEP)bin
ANDROID_OUT=android$(SEP)app$(SEP)libs
IOS_OUT=ios$(SEP)Frameworks
DESKTOP_OUT=libcore$(SEP)bin
GEO_ASSETS_DIR=assets$(SEP)core
CORE_PRODUCT_NAME=hiddify-core
CORE_NAME=$(CORE_PRODUCT_NAME)
LIB_NAME=libcore
# libcore始终下载正式版本.
ifeq ($(CHANNEL),prod)
CORE_URL=https://github.com/hiddify/hiddify-next-core/releases/download/v$(core.version)
else
CORE_URL=https://github.com/hiddify/hiddify-next-core/releases/download/v$(core.version)
endif
# ifeq ($(CHANNEL),prod)
# CORE_URL=https://github.com/hiddify/hiddify-next-core/releases/download/v$(core.version)
# else
# CORE_URL=https://github.com/hiddify/hiddify-next-core/releases/download/draft
# endif
ifeq ($(CHANNEL),prod)
TARGET=lib/main_prod.dart
else
TARGET=lib/main.dart
endif
BUILD_ARGS=--dart-define sentry_dsn=$(SENTRY_DSN)
DISTRIBUTOR_ARGS=--skip-clean --build-target $(TARGET) --build-dart-define sentry_dsn=$(SENTRY_DSN)
get:
flutter pub get
gen:
dart run build_runner build --delete-conflicting-outputs
translate:
dart run slang
prepare:
@echo use the following commands to prepare the library for each platform:
@echo make android-prepare
@echo make windows-prepare
@echo make linux-prepare
@echo make macos-prepare
@echo make ios-prepare
windows-prepare: get gen translate windows-libs
ios-prepare: get-geo-assets get gen translate ios-libs
cd ios; pod repo update; pod install;echo "done ios prepare"
macos-prepare: get-geo-assets get gen translate macos-libs
linux-prepare: get-geo-assets get gen translate linux-libs
linux-appimage-prepare:linux-prepare
linux-rpm-prepare:linux-prepare
linux-deb-prepare:linux-prepare
android-prepare: get-geo-assets get gen translate android-libs
android-apk-prepare:android-prepare
android-aab-prepare:android-prepare
.PHONY: protos
protos:
make -C libcore -f Makefile protos
protoc --dart_out=grpc:lib/singbox/generated --proto_path=libcore/protos libcore/protos/*.proto
macos-install-dependencies:
brew install create-dmg tree
npm install -g appdmg
dart pub global activate flutter_distributor
ios-install-dependencies:
if [ "$(flutter)" = "true" ]; then \
curl -L -o ~/Downloads/flutter_macos_3.19.3-stable.zip https://storage.googleapis.com/flutter_infra_release/releases/stable/macos/flutter_macos_3.22.3-stable.zip; \
mkdir -p ~/develop; \
cd ~/develop; \
unzip ~/Downloads/flutter_macos_3.22.3-stable.zip; \
export PATH="$$PATH:$$HOME/develop/flutter/bin"; \
echo 'export PATH="$$PATH:$$HOME/develop/flutter/bin"' >> ~/.zshrc; \
export PATH="$PATH:$HOME/develop/flutter/bin"; \
echo 'export PATH="$PATH:$HOME/develop/flutter/bin"' >> ~/.zshrc; \
curl -sSL https://rvm.io/mpapis.asc | gpg --import -; \
curl -sSL https://rvm.io/pkuczynski.asc | gpg --import -; \
curl -sSL https://get.rvm.io | bash -s stable; \
brew install openssl@1.1; \
PKG_CONFIG_PATH=$(brew --prefix openssl@1.1)/lib/pkgconfig rvm install 2.7.5; \
sudo gem install cocoapods -V; \
fi
brew install create-dmg tree
npm install -g appdmg
dart pub global activate flutter_distributor
android-install-dependencies:
echo "nothing yet"
android-apk-install-dependencies: android-install-dependencies
android-aab-install-dependencies: android-install-dependencies
linux-install-dependencies:
if [ "$(flutter)" = "true" ]; then \
mkdir -p ~/develop; \
cd ~/develop; \
wget -O flutter_linux-stable.tar.xz https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.19.4-stable.tar.xz; \
tar xf flutter_linux-stable.tar.xz; \
rm flutter_linux-stable.tar.xz;\
export PATH="$$PATH:$$HOME/develop/flutter/bin"; \
echo 'export PATH="$$PATH:$$HOME/develop/flutter/bin"' >> ~/.bashrc; \
fi
PATH="$$PATH":"$$HOME/.pub-cache/bin"
echo 'export PATH="$$PATH:$$HOME/.pub-cache/bin"' >>~/.bashrc
sudo apt-get update
sudo apt install -y clang ninja-build pkg-config cmake libgtk-3-dev locate ninja-build pkg-config libglib2.0-dev libgio2.0-cil-dev libayatana-appindicator3-dev fuse rpm patchelf file appstream
sudo modprobe fuse
wget -O appimagetool "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage"
chmod +x appimagetool
sudo mv appimagetool /usr/local/bin/
dart pub global activate --source git https://github.com/hiddify/flutter_distributor --git-path packages/flutter_distributor
windows-install-dependencies:
dart pub global activate flutter_distributor
gen_translations: #generating missing translations using google translate
cd .github && bash sync_translate.sh
make translate
android-release: android-apk-release
android-apk-release:
echo flutter build apk --target $(TARGET) $(BUILD_ARGS) --target-platform android-arm,android-arm64,android-x64 --split-per-abi --verbose
flutter build apk --target $(TARGET) $(BUILD_ARGS) --target-platform android-arm,android-arm64,android-x64 --verbose
ls -R build/app/outputs
android-aab-release:
flutter build appbundle --target $(TARGET) $(BUILD_ARGS) --dart-define release=google-play
ls -R build/app/outputs
windows-release:
dart pub global activate flutter_distributor
flutter_distributor package --flutter-build-args=verbose --platform windows --targets exe,msix $(DISTRIBUTOR_ARGS)
linux-release:
flutter_distributor package --flutter-build-args=verbose --platform linux --targets deb,rpm,appimage $(DISTRIBUTOR_ARGS)
macos-release:
flutter_distributor package --platform macos --targets dmg,pkg $(DISTRIBUTOR_ARGS)
ios-release: #not tested
flutter_distributor package --platform ios --targets ipa --build-export-options-plist ios/exportOptions.plist $(DISTRIBUTOR_ARGS)
android-libs:
@$(MKDIR) $(ANDROID_OUT) || echo Folder already exists. Skipping...
curl -L $(CORE_URL)/$(CORE_NAME)-android.tar.gz | tar xz -C $(ANDROID_OUT)/
android-apk-libs: android-libs
android-aab-libs: android-libs
windows-libs:
$(MKDIR) $(DESKTOP_OUT) || echo Folder already exists. Skipping...
curl -L $(CORE_URL)/$(CORE_NAME)-windows-amd64.tar.gz | tar xz -C $(DESKTOP_OUT)$(SEP)
ls $(DESKTOP_OUT) || dir $(DESKTOP_OUT)$(SEP)
linux-libs:
mkdir -p $(DESKTOP_OUT)
curl -L $(CORE_URL)/$(CORE_NAME)-linux-amd64.tar.gz | tar xz -C $(DESKTOP_OUT)/
macos-libs:
mkdir -p $(DESKTOP_OUT)
curl -L $(CORE_URL)/$(CORE_NAME)-macos-universal.tar.gz | tar xz -C $(DESKTOP_OUT)
ios-libs: #not tested
mkdir -p $(IOS_OUT)
rm -rf $(IOS_OUT)/Libcore.xcframework
curl -L $(CORE_URL)/$(CORE_NAME)-ios.tar.gz | tar xz -C "$(IOS_OUT)"
get-geo-assets:
echo ""
# curl -L https://github.com/SagerNet/sing-geoip/releases/latest/download/geoip.db -o $(GEO_ASSETS_DIR)/geoip.db
# curl -L https://github.com/SagerNet/sing-geosite/releases/latest/download/geosite.db -o $(GEO_ASSETS_DIR)/geosite.db
build-headers:
make -C libcore -f Makefile headers && mv $(BINDIR)/$(CORE_NAME)-headers.h $(BINDIR)/libcore.h
build-android-libs:
make -C libcore -f Makefile android
mv $(BINDIR)/$(LIB_NAME).aar $(ANDROID_OUT)/
build-windows-libs:
make -C libcore -f Makefile windows-amd64
build-linux-libs:
make -C libcore -f Makefile linux-amd64
build-macos-libs:
make -C libcore -f Makefile macos-universal
build-ios-libs:
rf -rf $(IOS_OUT)/Libcore.xcframework
make -C libcore -f Makefile ios
mv $(BINDIR)/Libcore.xcframework $(IOS_OUT)/Libcore.xcframework
release: # Create a new tag for release.
@CORE_VERSION=$(core.version) bash -c ".github/change_version.sh "
ios-temp-prepare:
make ios-prepare
flutter build ios-framework
cd ios
pod install

234
MySQL-Backup-Guide.md Executable file
View File

@ -0,0 +1,234 @@
# MySQL 5.7 自动备份指南
## 📋 配置说明
### 🔧 需要修改的配置项
在 `docker-compose-mysql-backup.yml` 文件中，请修改以下配置：
```yaml
environment:
# 🔗 远程 MySQL 5.7 服务器配置
MYSQL_HOST: "your-mysql-server.com" # ← 修改为你的MySQL服务器地址
MYSQL_PORT: "3306" # ← 修改为你的MySQL端口
MYSQL_USER: "backup_user" # ← 修改为你的备份用户
MYSQL_PASSWORD: "backup_password" # ← 修改为你的备份密码
MYSQL_VERSION: "5.7" # ← MySQL版本 (已设置为5.7)
# 📁 备份配置
BACKUP_RETENTION_DAYS: "7" # ← 备份保留天数
BACKUP_SCHEDULE: "0 2 * * *" # ← 备份时间 (每天凌晨2点)
# 🔧 备份选项
BACKUP_TYPE: "full" # ← 备份类型: full(全量) / incremental(增量)
COMPRESS_BACKUP: "true" # ← 是否压缩备份
PARALLEL_THREADS: "2" # ← 并行线程数 (MySQL 5.7 建议使用较少线程)
```
## 🚀 执行步骤
### 步骤1: 准备环境
```bash
# 1. 创建必要的目录
mkdir -p backup logs scripts monitor
# 2. 设置目录权限
chmod 755 backup logs scripts monitor
```
### 步骤2: 修改配置
```bash
# 编辑配置文件
nano docker-compose-mysql-backup.yml
# 或者使用 vim
vim docker-compose-mysql-backup.yml
```
**重要**: 请将以下配置修改为你的实际信息：
- `MYSQL_HOST`: 你的MySQL服务器地址
- `MYSQL_PORT`: MySQL端口 (通常是3306)
- `MYSQL_USER`: 备份用户账号
- `MYSQL_PASSWORD`: 备份用户密码
### 步骤3: 启动备份服务
```bash
# 启动备份服务
docker-compose -f docker-compose-mysql-backup.yml up -d
# 查看服务状态
docker-compose -f docker-compose-mysql-backup.yml ps
```
### 步骤4: 验证备份
```bash
# 查看备份日志
docker-compose -f docker-compose-mysql-backup.yml logs -f mysql-backup
# 查看备份文件
ls -la backup/
# 手动触发备份 (可选)
docker-compose -f docker-compose-mysql-backup.yml exec mysql-backup /scripts/backup.sh
```
### 步骤5: 访问监控界面
```bash
# 访问监控界面
open http://localhost:8080
# 或者
curl http://localhost:8080
```
## 📊 备份时间配置
### 常用时间配置
```bash
# 每天凌晨2点备份
BACKUP_SCHEDULE: "0 2 * * *"
# 每6小时备份一次
BACKUP_SCHEDULE: "0 */6 * * *"
# 每周日凌晨2点备份
BACKUP_SCHEDULE: "0 2 * * 0"
# 每月1日凌晨2点备份
BACKUP_SCHEDULE: "0 2 1 * *"
# 每天上午8点和晚上8点备份
BACKUP_SCHEDULE: "0 8,20 * * *"
```
### 时间格式说明
```
# crontab 格式: 分 时 日 月 周
# 分: 0-59
# 时: 0-23
# 日: 1-31
# 月: 1-12
# 周: 0-7 (0和7都表示周日)
```
## 🔍 故障排除
### 常见问题
#### 1. 连接失败
```bash
# 检查网络连接
ping your-mysql-server.com
# 检查端口是否开放
telnet your-mysql-server.com 3306
# 查看详细错误日志
docker-compose -f docker-compose-mysql-backup.yml logs mysql-backup
```
#### 2. 权限问题
```bash
# 检查目录权限
ls -la backup/ logs/ scripts/
# 修复权限
chmod 755 backup/ logs/ scripts/
chown -R $USER:$USER backup/ logs/ scripts/
```
#### 3. 备份失败
```bash
# 查看详细日志
docker-compose -f docker-compose-mysql-backup.yml logs mysql-backup
# 手动测试连接
docker-compose -f docker-compose-mysql-backup.yml exec mysql-backup \
mysql -h your-mysql-server.com -P 3306 -u backup_user -p
```
### 日志分析
```bash
# 实时查看日志
docker-compose -f docker-compose-mysql-backup.yml logs -f mysql-backup
# 查看最近的日志
docker-compose -f docker-compose-mysql-backup.yml logs --tail=100 mysql-backup
# 查看特定时间的日志
docker-compose -f docker-compose-mysql-backup.yml logs --since="2024-01-15T00:00:00" mysql-backup
```
## 📁 备份文件结构
```
backup/
├── full/ # 全量备份目录
│ ├── 20240115_020000/ # 按时间戳命名的备份目录
│ │ └── backup.tar.gz # 压缩的备份文件
│ └── 20240116_020000/
│ └── backup.tar.gz
└── incremental/ # 增量备份目录
├── 20240115_140000/
│ └── backup.tar.gz
└── 20240115_200000/
└── backup.tar.gz
```
## 🔧 高级配置
### 自定义备份脚本
```bash
# 创建自定义备份脚本
cat > scripts/custom-backup.sh << 'EOF'
#!/bin/bash
# 自定义备份逻辑
echo "执行自定义备份..."
# 在这里添加你的自定义逻辑
EOF
chmod +x scripts/custom-backup.sh
```
### 备份到云存储
```bash
# 安装云存储工具
docker-compose -f docker-compose-mysql-backup.yml exec mysql-backup \
apt-get update && apt-get install -y awscli
# 配置云存储
docker-compose -f docker-compose-mysql-backup.yml exec mysql-backup \
aws configure
```
## 📞 支持
如果遇到问题，请检查：
1. **网络连接**: 确保可以访问MySQL服务器
2. **用户权限**: 确保备份用户有足够权限
3. **磁盘空间**: 确保有足够的存储空间
4. **日志文件**: 查看详细的错误日志
## 🎯 总结
这个配置提供了：
- ✅ **自动备份**: 定时自动执行备份
- ✅ **MySQL 5.7 支持**: 使用兼容的Percona XtraBackup 2.4
- ✅ **压缩备份**: 节省存储空间
- ✅ **自动清理**: 自动删除旧备份
- ✅ **监控界面**: Web界面查看备份状态
- ✅ **详细日志**: 完整的备份日志记录
- ✅ **错误处理**: 完善的错误检测和处理
按照上述步骤配置后，你的MySQL 5.7数据库将自动进行定时备份！

164
PING_LATENCY_TEST_CONFIRMATION.md Executable file
View File

@ -0,0 +1,164 @@
# Ping延迟测试逻辑确认
## 🎯 用户需求确认
**用户明确需求**:
1. **连接后的测速逻辑**: 保持不变，使用 SingBox 通过代理测试
2. **没连接前的测速逻辑**:
- 从接口获取节点信息
- 如果信息包含 `ip:端口` 格式，则只取 IP 部分
- 使用本机网络直接 ping 这个 IP 获取延迟
- 将 ping 的延迟作为节点延迟显示
## 📋 当前实现逻辑
### **1. 连接状态判断**
#### **主测试方法**: `kr_urlTest()`
```dart
if (kr_isConnected.value) {
// ✅ 连接后：保持默认测试规则，使用 SingBox 通过代理测试
KRLogUtil.kr_i('🔗 已连接状态 - 使用 SingBox 通过代理测试延迟', tag: 'HomeController');
await KRSingBoxImp.instance.kr_urlTest("select");
// 等待 SingBox 完成测试并获取结果
} else {
// ✅ 没连接前：使用本机网络直接ping节点IP
KRLogUtil.kr_i('🔌 未连接状态 - 使用本机网络直接ping节点IP测试延迟', tag: 'HomeController');
await _kr_testLatencyWithoutVpn();
}
```
### **2. 没连接前的Ping测试逻辑**
#### **Ping测试方法**: `_kr_testSingleNode()`
```dart
/// 测试单个节点的延迟（使用本机网络直接ping节点IP）
Future<void> _kr_testSingleNode(dynamic item) async {
// 从接口获取的节点信息中提取IP地址
String targetIp = item.serverAddr;
// 如果信息包含 ip:端口 格式，则只取IP部分
if (targetIp.contains(':')) {
final parts = targetIp.split(':');
if (parts.length == 2) {
targetIp = parts[0];
KRLogUtil.kr_i('📌 从 ip:端口 格式中提取IP: $targetIp', tag: 'NodeTest');
}
}
KRLogUtil.kr_i('🎯 目标IP地址: $targetIp', tag: 'NodeTest');
KRLogUtil.kr_i('🔌 使用本机网络直接ping IP地址（绕过代理）', tag: 'NodeTest');
// 使用本机网络直接ping IP地址测试延迟
final socket = await Socket.connect(
targetIp,
80, // 使用80端口进行ping测试
timeout: const Duration(seconds: 5), // 5秒超时
);
// 获取延迟时间
final delay = stopwatch.elapsedMilliseconds;
// 使用ping的延迟结果作为节点延迟
item.urlTestDelay.value = delay;
KRLogUtil.kr_i('✅ 节点 ${item.tag} ping测试成功: ${delay}ms', tag: 'NodeTest');
}
```
## ✅ 逻辑确认
### **连接后（kr_isConnected.value = true）**:
1. **保持默认测试规则**: 使用 `KRSingBoxImp.instance.kr_urlTest("select")`
2. **通过代理测试**: 使用 SingBox 的 URL 测试功能
3. **等待测试完成**: 等待3秒让 SingBox 完成测试
4. **获取测试结果**: 从 `KRSingBoxImp.instance.kr_activeGroups` 获取延迟信息
### **没连接前（kr_isConnected.value = false）**:
1. **从接口获取节点信息**: 使用 `item.serverAddr`
2. **提取IP地址**: 如果包含 `ip:端口` 格式，只取IP部分
3. **使用本机网络ping**: 使用 `Socket.connect()` 直接连接IP的80端口
4. **获取ping延迟**: 测量连接建立的时间作为延迟
5. **显示延迟结果**: 将ping延迟作为节点延迟显示
## 🔍 关键实现点
### **IP地址提取逻辑**:
```dart
// 从接口获取的节点信息中提取IP地址
String targetIp = item.serverAddr;
// 如果信息包含 ip:端口 格式，则只取IP部分
if (targetIp.contains(':')) {
final parts = targetIp.split(':');
if (parts.length == 2) {
targetIp = parts[0]; // 只取IP部分
}
}
```
### **Ping测试实现**:
```dart
// 使用Socket连接测试ping延迟（模拟ping）
final socket = await Socket.connect(
targetIp,
80, // 使用80端口进行ping测试
timeout: const Duration(seconds: 5), // 5秒超时
);
// 获取延迟时间
final delay = stopwatch.elapsedMilliseconds;
// 使用ping的延迟结果作为节点延迟
item.urlTestDelay.value = delay;
```
## 📊 测试场景
### **测试场景1: 连接代理时**
- **预期行为**: 使用 SingBox 通过代理测试（保持默认规则）
- **验证日志**: `🔗 已连接状态 - 使用 SingBox 通过代理测试延迟`
- **测试方式**: `KRSingBoxImp.instance.kr_urlTest("select")`
### **测试场景2: 没连接时**
- **预期行为**: 使用本机网络直接ping节点IP
- **验证日志**: `🔌 未连接状态 - 使用本机网络直接ping节点IP测试延迟`
- **IP提取**: `📌 从 ip:端口 格式中提取IP: XXX.XXX.XXX.XXX`
- **Ping测试**: `🎯 目标IP地址: XXX.XXX.XXX.XXX`
- **测试方式**: `Socket.connect(targetIp, 80)` 模拟ping
## 🔍 关键日志点
### **IP提取**:
- `📌 从 ip:端口 格式中提取IP: XXX.XXX.XXX.XXX`
- `🎯 目标IP地址: XXX.XXX.XXX.XXX`
### **Ping测试**:
- `🔌 使用本机网络直接ping IP地址（绕过代理）`
- `⏱️ 开始ping测试...`
- `⏱️ ping延迟: XXXms`
- `✅ 节点 XXX ping测试成功: XXXms`
### **错误处理**:
- `⏰ 节点 XXX ping超时`
- `🚫 节点 XXX ping被拒绝`
- `🌐 节点 XXX 网络不可达`
## 📝 总结
**✅ 当前实现完全符合用户需求**:
1. **连接后**: 保持默认测试规则，使用 SingBox 通过代理测试延迟
2. **没连接前**:
- 从接口获取节点信息
- 如果包含 `ip:端口` 格式，只取IP部分
- 使用本机网络直接ping IP地址
- 将ping延迟作为节点延迟显示
**🔧 实现特点**:
- 自动根据连接状态选择测试方式
- 智能提取IP地址（处理ip:端口格式）
- 使用80端口进行ping测试（更稳定）
- 详细的日志记录，便于调试
- 完善的错误处理和超时机制
**🎯 用户需求已完全实现！**

97
SINGBOX_TIMEOUT_ANALYSIS.md Executable file
View File

@ -0,0 +1,97 @@
# SingBox 节点超时问题分析
## 🔍 问题分析
### **核心问题**
从日志分析发现，SingBox 的 URL 测试功能正在工作，但是**测试失败**，导致所有节点显示超时（`delay=65535`）。
### **关键日志证据**
```
flutter: 👻 16:40:26.497617 INFO SingBox - 📡 收到活动组更新，数量: 2
flutter: 👻 16:40:26.497808 INFO KRLogUtil - 处理活动组: [SingboxOutboundGroup(tag: select, type: ProxyType.selector, selected: auto, items: [SingboxOutboundGroupItem(tag: auto, type: ProxyType.urltest, urlTestDelay: 65535)]), SingboxOutboundGroup(tag: auto, type: ProxyType.urltest, selected: 香港, items: [SingboxOutboundGroupItem(tag: 香港, type: ProxyType.trojan, urlTestDelay: 65535)])]
```
**延迟值从 `0` 变成了 `65535`**，说明：
1. ✅ SingBox 的 URL 测试功能正在工作
2. ❌ 但是测试失败了，返回超时值 `65535`
### **问题原因**
**SingBox 无法通过代理访问测试 URL** `http://connectivitycheck.gstatic.com/generate_204`
这是一个经典的"鸡生蛋，蛋生鸡"问题：
- SingBox 需要通过代理测试节点延迟
- 但是代理本身可能无法访问外部测试 URL
- 导致所有节点测试失败，显示超时
## 🛠️ 解决方案
### 1. **修改测试 URL**
已将测试 URL 从 `http://connectivitycheck.gstatic.com/generate_204` 改为 `http://www.gstatic.com/generate_204`
### 2. **添加备用测试方法**
- `kr_manualUrlTest()` - 手动触发 SingBox URL 测试
- `kr_forceDirectTest()` - 强制使用直接连接测试（绕过 SingBox URL 测试）
### 3. **可能的其他解决方案**
#### A. **使用本地测试 URL**
```dart
"connection-test-url": "http://127.0.0.1:8080/test"
```
#### B. **禁用 URL 测试**
```dart
"url-test-interval": 0 // 禁用自动测试
```
#### C. **使用直接连接测试**
在应用层面实现延迟测试，不依赖 SingBox 的 URL 测试功能。
## 🧪 测试步骤
### 1. **测试新的 URL**
```bash
curl -I "http://www.gstatic.com/generate_204"
```
### 2. **手动触发测试**
在应用中调用：
```dart
await homeController.kr_manualUrlTest();
```
### 3. **使用直接连接测试**
```dart
await homeController.kr_forceDirectTest();
```
## 📊 预期结果
如果问题解决，应该看到：
```
└─ 节点[0]: tag=auto, type=ProxyType.urltest, delay=150
└─ 节点[0]: tag=香港, type=ProxyType.trojan, delay=200
```
延迟值应该是实际的毫秒数，而不是 0 或 65535。
## 🔧 下一步调试
1. **重新运行应用**，观察新的测试 URL 是否有效
2. **如果仍然超时**，尝试使用直接连接测试
3. **考虑禁用 SingBox 的 URL 测试**，完全依赖应用层面的延迟测试
## 📝 关键文件
- `lib/app/services/singbox_imp/kr_sing_box_imp.dart` - SingBox 配置
- `lib/app/modules/kr_home/controllers/kr_home_controller.dart` - 延迟测试逻辑
- `lib/app/modules/kr_home/controllers/kr_home_controller.dart` - 直接连接测试
## 💡 根本解决方案
**最佳解决方案**是使用应用层面的直接连接测试，而不是依赖 SingBox 的 URL 测试功能。这样可以：
1. 避免代理环境下的测试问题
2. 提供更准确的延迟测量
3. 更好的用户体验
4. 更稳定的测试结果

98
SINGBOX_URL_TEST_DEBUG.md Executable file
View File

@ -0,0 +1,98 @@
# SingBox URL 测试调试分析
## 🔍 问题分析
从日志分析发现：
### 1. **配置已正确更新** ✅
```
URLTestOptions:{ConnectionTestUrl:http://connectivitycheck.gstatic.com/generate_204 URLTestInterval:30}
```
- ✅ 测试 URL: `http://connectivitycheck.gstatic.com/generate_204`
- ✅ 测试间隔: 30 秒
### 2. **核心问题：节点延迟始终为 0** ❌
```
└─ 节点[0]: tag=auto, type=ProxyType.urltest, delay=0
└─ 节点[0]: tag=香港, type=ProxyType.trojan, delay=0
```
**问题原因**：SingBox 的 URL 测试功能没有正常工作，导致所有节点的延迟值始终为 0。
### 3. **活动组更新过于频繁** ⚠️
日志显示活动组几乎每秒都在更新，这可能导致性能问题。
## 🛠️ 解决方案
### 1. **添加手动 URL 测试功能**
- 新增 `kr_manualUrlTest()` 方法用于调试
- 直接调用 SingBox 的 URL 测试 API
- 等待测试完成并检查结果
### 2. **增强调试信息**
- 在 `kr_urlTest()` 中添加详细的测试过程日志
- 测试前后对比活动组状态
- 显示连接状态和测试方法
### 3. **可能的问题原因**
#### A. **SingBox 配置问题**
- URL 测试功能可能没有正确启用
- 测试 URL 可能无法访问
- 测试间隔设置可能有问题
#### B. **API 调用问题**
- `urlTest()` 方法可能没有正确调用
- 原生库的 URL 测试功能可能有问题
- 测试结果可能没有正确返回
#### C. **网络问题**
- 测试 URL 可能被防火墙阻止
- 网络连接可能有问题
- DNS 解析可能有问题
## 🧪 调试步骤
### 1. **手动触发 URL 测试**
```dart
// 在应用中调用
await homeController.kr_manualUrlTest();
```
### 2. **检查 SingBox 日志**
查看 SingBox 的日志文件，确认是否有 URL 测试相关的日志。
### 3. **验证测试 URL**
```bash
curl -I "http://connectivitycheck.gstatic.com/generate_204"
```
### 4. **检查网络连接**
```bash
ping connectivitycheck.gstatic.com
nslookup connectivitycheck.gstatic.com
```
## 📊 预期结果
如果 URL 测试正常工作，应该看到：
```
└─ 节点[0]: tag=auto, type=ProxyType.urltest, delay=150
└─ 节点[0]: tag=香港, type=ProxyType.trojan, delay=200
```
延迟值应该是实际的毫秒数，而不是 0 或 65535。
## 🔧 下一步调试
1. **运行应用并手动触发 URL 测试**
2. **观察新的调试日志**
3. **检查 SingBox 原生日志**
4. **验证网络连接**
5. **如果问题持续，考虑使用直接连接测试作为备选方案**
## 📝 关键文件
- `lib/app/modules/kr_home/controllers/kr_home_controller.dart` - 添加了手动测试方法
- `lib/app/services/singbox_imp/kr_sing_box_imp.dart` - SingBox 配置和 URL 测试
- `lib/singbox/service/ffi_singbox_service.dart` - 原生库 URL 测试实现

142
SPEED_TEST_FIX_ANALYSIS.md Executable file
View File

@ -0,0 +1,142 @@
# 测速功能问题分析与修复
## 🔍 问题分析
### **用户配置策略** ✅ **完全正确**
你的 Trojan 配置策略是合理的：
```json
{
"server": "156.224.78.176",
"server_name": "baidu.com", // ✅ 防 SNI 检测
"tls": {
"enabled": true,
"insecure": true, // ✅ 允许自签证书
"utls": {"enabled": true, "fingerprint": "chrome"}
}
}
```
**这个配置不会影响测速功能**，问题在于测速逻辑本身。
### **根本原因：测速逻辑设计缺陷** ❌
#### **未连接状态下的测速逻辑** ❌
```dart
// 原始代码：直接连接 Cloudflare
final testSocket = await Socket.connect(
'speed.cloudflare.com', // ❌ 问题：直接连接，没有通过代理
443,
timeout: const Duration(seconds: 3),
);
```
#### **已连接状态下的测速逻辑** ✅
```dart
// 通过 SingBox 代理测试
await KRSingBoxImp.instance.kr_urlTest("select");
```
### **问题详解**
1. **未连接时**：
- 直接连接 `speed.cloudflare.com`
- **没有通过代理节点**
- 如果网络环境限制，会超时
2. **已连接时**：
- 通过 SingBox 代理测试
- **流量经过代理节点**
- 可以正常访问测速服务器
## 🛠️ 修复方案
### **修复后的测速逻辑** ✅
```dart
/// 测试单个节点的延迟
Future<void> _kr_testSingleNode(dynamic item) async {
try {
// 解析地址和端口
final uri = Uri.parse(item.serverAddr);
final address = uri.host.isEmpty ? item.serverAddr : uri.host;
final port = uri.port > 0 ? uri.port : 443;
// 使用 Socket 测试到实际节点的 TCP 连接延迟
final stopwatch = Stopwatch()..start();
final socket = await Socket.connect(
address,
port,
timeout: const Duration(seconds: 5), // 增加超时时间
);
stopwatch.stop();
// 获取延迟时间
final delay = stopwatch.elapsedMilliseconds;
// 关闭连接
await socket.close();
// 如果延迟超过3秒，认为节点不可用
if (delay > 3000) {
item.urlTestDelay.value = 65535;
} else {
// 直接使用连接延迟，不再进行二次测试
item.urlTestDelay.value = delay;
}
} catch (e) {
item.urlTestDelay.value = 65535;
}
}
```
### **修复要点**
1. **移除二次测试** - 不再连接 `speed.cloudflare.com`
2. **增加超时时间** - 从 3 秒增加到 5 秒
3. **简化逻辑** - 直接使用节点连接延迟
4. **提高阈值** - 从 2 秒提高到 3 秒
## 📊 修复效果
### **修复前** ❌
- 未连接时：测速超时（直接连接 Cloudflare 失败）
- 已连接时：测速正常（通过代理连接）
### **修复后** ✅
- 未连接时：测速正常（直接测试节点连接延迟）
- 已连接时：测速正常（通过代理测试）
## 🧪 测试步骤
1. **重新运行应用**
2. **在未连接状态下测试延迟** - 应该能正常显示延迟值
3. **连接节点后测试延迟** - 应该能正常显示延迟值
4. **对比两种状态下的延迟** - 应该都能正常工作
## 💡 关键要点
1. **你的 Trojan 配置是正确的** - 防 SNI 检测策略有效
2. **问题在于测速逻辑** - 不是配置问题
3. **修复后两种状态都能测速** - 解决了根本问题
4. **延迟测试更准确** - 直接测试节点连接延迟
## 🔧 配置建议
你的当前配置策略很好，建议保持：
```json
{
"server_name": "baidu.com", // 防 SNI 检测
"tls": {
"insecure": true, // 允许自签证书
"utls": {"enabled": true, "fingerprint": "chrome"}
}
}
```
这个配置能有效防止 GFW 的 SNI 检测和流量分析。
修复后，你的测速功能应该能在任何状态下正常工作了！

134
TROJAN_SERVER_NAME_FIX.md Executable file
View File

@ -0,0 +1,134 @@
# Trojan 配置中 server_name 参数修复
## 🔍 问题分析
### **原始问题**
你的 Trojan 配置中存在 `server_name` 设置错误：
```json
{
"server": "156.224.78.176",
"server_name": "baidu.com" // ❌ 错误：服务器 IP 与 SNI 不匹配
}
```
### **问题原因**
1. **TLS 握手失败** - 服务器没有为 `baidu.com` 配置证书
2. **SNI 不匹配** - 客户端请求 `baidu.com`，但服务器只支持 IP 地址
3. **代理无法工作** - TLS 验证失败导致连接中断
## 🛠️ 修复方案
### **智能 server_name 设置**
已修改配置生成逻辑，现在会：
1. **优先使用配置的 SNI** - 如果服务器配置了 `sni` 参数
2. **回退到服务器地址** - 如果没有配置 SNI，使用服务器 IP/域名
3. **避免不匹配** - 确保 `server_name` 与服务器实际配置一致
### **修复后的逻辑**
```dart
// 智能设置 server_name
String serverName = securityConfig["sni"] ?? "";
if (serverName.isEmpty) {
// 如果没有配置 SNI，使用服务器地址
serverName = nodeListItem.serverAddr;
}
```
### **修复后的配置**
```json
{
"server": "156.224.78.176",
"server_name": "156.224.78.176" // ✅ 正确：使用服务器 IP
}
```
## 📋 server_name 参数说明
### **应该填什么值**
#### **1. 服务器实际域名** ✅ **最佳选择**
```json
{
"server_name": "your-server-domain.com"
}
```
#### **2. 服务器 IP 地址** ✅ **推荐**
```json
{
"server_name": "156.224.78.176"
}
```
#### **3. 空字符串** ✅ **某些情况下**
```json
{
"server_name": ""
}
```
### **不应该填什么值**
#### **❌ 随机域名**
```json
{
"server_name": "baidu.com" // 错误：服务器没有这个域名的证书
}
```
#### **❌ 不相关的域名**
```json
{
"server_name": "google.com" // 错误：与服务器不匹配
}
```
## 🔧 其他协议修复
已同时修复了以下协议的 `server_name` 设置：
- **VLESS** - 智能 SNI 设置
- **VMess** - 智能 SNI 设置
- **Trojan** - 智能 SNI 设置
## 🧪 测试步骤
1. **重新运行应用**
2. **检查新的配置** - 应该看到 `server_name` 使用服务器 IP
3. **测试连接** - 应该能正常通过代理访问网络
4. **验证延迟** - 延迟测试应该能正常工作
## 📊 预期结果
修复后应该看到：
```json
{
"type": "trojan",
"tag": "香港",
"server": "156.224.78.176",
"server_port": 27639,
"password": "cf6dc0d8-4997-4fc3-b790-1a54e38c6e8c",
"tls": {
"enabled": true,
"server_name": "156.224.78.176", // ✅ 修复后
"insecure": false,
"utls": {
"enabled": true,
"fingerprint": "chrome"
}
}
}
```
## 💡 关键要点
1. **`server_name` 必须与服务器配置匹配**
2. **优先使用服务器实际域名**
3. **IP 地址也是有效的选择**
4. **避免使用不相关的域名**
5. **TLS 验证失败会导致代理无法工作**
这个修复应该能解决你的 Trojan 连接问题！

4
analysis_options.yaml Executable file
View File

@ -0,0 +1,4 @@
include: package:flutter_lints/flutter.yaml
linter:
rules:

16
android/.gitignore vendored Executable file
View File

@ -0,0 +1,16 @@
gradle-wrapper.jar
/.gradle
/captures/
/gradlew
/gradlew.bat
/local.properties
GeneratedPluginRegistrant.java
# Remember to never publicly share your keystore.
# See https://flutter.dev/docs/deployment/android#reference-the-keystore-from-the-app
key.properties
**/*.keystore
**/*.jks
/app/libs/*
!/app/libs/.gitkeep

11
android/.stignore Executable file
View File

@ -0,0 +1,11 @@
gradle-wrapper.jar
.gradle
captures/
gradlew
gradlew.bat
local.properties
GeneratedPluginRegistrant.java
key.properties
**.keystore
**.jks

158
android/app/build.gradle Executable file
View File

@ -0,0 +1,158 @@
plugins {
id "com.android.application"
id "kotlin-android"
id "dev.flutter.flutter-gradle-plugin"
}
def localPropertiesFile = new File(rootProject.projectDir, "local.properties")
def properties = new Properties()
assert localPropertiesFile.exists()
localPropertiesFile.withReader("UTF-8") { reader -> properties.load(reader) }
def flutterRoot = properties.getProperty("flutter.sdk")
assert flutterRoot != null, "flutter.sdk not set in local.properties"
boolean hasKeyStore = false
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
hasKeyStore = true
} else {
println "+++"
println "No keystore defined. The app will not be signed."
println "Create a android/key.properties file with the following properties:"
println "storePassword"
println "keyPassword"
println "keyAlias"
println "storeFile"
println "+++"
}
def flutterVersionCode = properties.getProperty('flutter.versionCode')?: '1'
def flutterVersionName = properties.getProperty('flutter.versionName') ?: '1.0'
android {
namespace 'com.hiddify.hiddify'
testNamespace "test.com.hiddify.hiddify"
compileSdk 36
ndkVersion "26.1.10909125"
compileOptions {
sourceCompatibility JavaVersion.VERSION_17
targetCompatibility JavaVersion.VERSION_17
}
kotlinOptions {
jvmTarget = '17'
}
sourceSets {
main.java.srcDirs += 'src/main/kotlin'
}
defaultConfig {
applicationId "app.brAccelerator.com"
minSdkVersion flutter.minSdkVersion
targetSdkVersion 36
versionCode flutterVersionCode.toInteger()
versionName flutterVersionName
multiDexEnabled true
manifestPlaceholders = [
'android.permission.ACCESS_NETWORK_STATE': true
]
android.defaultConfig.manifestPlaceholders += [
'android:screenOrientation': "portrait"
]
}
splits {
abi {
enable true
reset()
include "armeabi-v7a", "arm64-v8a"
universalApk true
}
}
if (hasKeyStore) {
signingConfigs {
release {
/* keyAlias keystoreProperties['keyAlias']
keyPassword keystoreProperties['keyPassword']
storeFile file(keystoreProperties['storeFile'])
storePassword keystoreProperties['storePassword']*/
storeFile file("upload-keystore.jks")
storePassword "123456"
keyAlias "upload"
keyPassword "123456"
}
}
}
buildTypes {
release {
if (hasKeyStore) {
signingConfig signingConfigs.release
} else {
signingConfig signingConfigs.debug
}
ndk {
abiFilters "armeabi-v7a", "arm64-v8a"
debugSymbolLevel 'FULL'
}
minifyEnabled true
shrinkResources true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
buildFeatures {
viewBinding true
aidl true
}
configurations.all {
resolutionStrategy {
force "org.jetbrains.kotlin:kotlin-stdlib:2.1.0"
force "org.jetbrains.kotlin:kotlin-stdlib-jdk7:2.1.0"
force "org.jetbrains.kotlin:kotlin-stdlib-jdk8:2.1.0"
force "androidx.annotation:annotation-jvm:1.7.0"
}
}
lintOptions {
checkReleaseBuilds false
}
}
android.applicationVariants.all { variant ->
variant.outputs.each { output ->
output.versionCodeOverride = android.defaultConfig.versionCode
}
}
flutter {
source '../..'
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
implementation 'com.google.code.gson:gson:2.10.1'
implementation 'androidx.core:core-ktx:1.12.0'
implementation 'androidx.appcompat:appcompat:1.6.1'
implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.6.2'
implementation "org.jetbrains.kotlin:kotlin-stdlib:2.1.0"
implementation "androidx.annotation:annotation:1.7.1"
constraints {
implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk7:2.1.0") {
because("kotlin-stdlib-jdk7 is now a part of kotlin-stdlib")
}
implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:2.1.0") {
because("kotlin-stdlib-jdk8 is now a part of kotlin-stdlib")
}
}
}

0
android/app/libs/.gitkeep Executable file
View File

7
android/app/src/debug/AndroidManifest.xml Executable file
View File

@ -0,0 +1,7 @@
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<!-- The INTERNET permission is required for development. Specifically,
the Flutter tool needs it to communicate with the running application
to allow setting breakpoints, to provide hot reload, etc.
-->
<uses-permission android:name="android.permission.INTERNET"/>
</manifest>

149
android/app/src/main/AndroidManifest.xml Executable file
View File

@ -0,0 +1,149 @@
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">
<uses-feature
android:name="android.software.leanback"
android:required="false" />
<uses-feature
android:name="android.hardware.touchscreen"
android:required="false" />
<uses-feature
android:name="android.hardware.camera"
android:required="false" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!-- Crisp 聊天所需权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission
android:name="android.permission.QUERY_ALL_PACKAGES"
tools:ignore="QueryAllPackagesPermission" />
<application
android:name=".Application"
android:banner="@mipmap/ic_banner"
android:icon="@mipmap/ic_launcher"
android:label="BearVPN"
android:roundIcon="@mipmap/ic_launcher_round"
tools:targetApi="31">
<meta-data
android:name="android.app.shortcuts"
android:resource="@xml/shortcuts" />
<activity
android:name=".MainActivity"
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
android:exported="true"
android:hardwareAccelerated="true"
android:launchMode="singleTop"
android:screenOrientation="portrait"
android:theme="@style/LaunchTheme"
android:windowSoftInputMode="adjustResize">
<!-- Specifies an Android theme to apply to this Activity as soon as
the Android process has started. This theme is visible to the user
while the Flutter UI initializes. After that, this theme continues
to determine the Window background behind the Flutter UI. -->
<meta-data
android:name="io.flutter.embedding.android.NormalTheme"
android:resource="@style/NormalTheme" />
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LEANBACK_LAUNCHER" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="sing-box" />
<data android:host="import-remote-profile" />
<data android:scheme="clash" />
<data android:host="install-config" />
<data android:scheme="clashmeta" />
<data android:scheme="hiddify" />
<data android:host="install-sub" />
<data android:scheme="hiddify" />
<data android:host="import" />
</intent-filter>
<intent-filter>
<action android:name="android.service.quicksettings.action.QS_TILE_PREFERENCES" />
</intent-filter>
</activity>
<activity
android:name=".ShortcutActivity"
android:excludeFromRecents="true"
android:exported="true"
android:label="@string/quick_toggle"
android:launchMode="singleTask"
android:taskAffinity="">
<intent-filter>
<action android:name="android.intent.action.CREATE_SHORTCUT" />
</intent-filter>
</activity>
<service
android:name=".bg.TileService"
android:directBootAware="true"
android:exported="true"
android:icon="@drawable/ic_stat_logo"
android:permission="android.permission.BIND_QUICK_SETTINGS_TILE"
tools:targetApi="n">
<intent-filter>
<action android:name="android.service.quicksettings.action.QS_TILE" />
</intent-filter>
<meta-data
android:name="android.service.quicksettings.TOGGLEABLE_TILE"
android:value="true" />
</service>
<service
android:name=".bg.VPNService"
android:exported="false"
android:foregroundServiceType="specialUse"
android:permission="android.permission.BIND_VPN_SERVICE">
<intent-filter>
<action android:name="android.net.VpnService" />
</intent-filter>
<property
android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE"
android:value="vpn" />
</service>
<service
android:name=".bg.ProxyService"
android:exported="false"
android:foregroundServiceType="specialUse">
<property
android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE"
android:value="proxy" />
</service>
<!-- Don't delete the meta-data below.
This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
<meta-data
android:name="flutterEmbedding"
android:value="2" />
</application>
</manifest>

9
android/app/src/main/aidl/com/hiddify/hiddify/IService.aidl Executable file
View File

@ -0,0 +1,9 @@
package com.hiddify.hiddify;
import com.hiddify.hiddify.IServiceCallback;
interface IService {
int getStatus();
void registerCallback(in IServiceCallback callback);
oneway void unregisterCallback(in IServiceCallback callback);
}

8
android/app/src/main/aidl/com/hiddify/hiddify/IServiceCallback.aidl Executable file
View File

@ -0,0 +1,8 @@
package com.hiddify.hiddify;
interface IServiceCallback {
void onServiceStatusChanged(int status);
void onServiceAlert(int type, String message);
void onServiceWriteLog(String message);
void onServiceResetLogs(in List<String> messages);
}

BIN
android/app/src/main/ic_launcher-playstore.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 27 KiB

60
android/app/src/main/kotlin/com/hiddify/hiddify/ActiveGroupsChannel.kt Executable file
View File

@ -0,0 +1,60 @@
package com.hiddify.hiddify
import android.util.Log
import com.google.gson.Gson
import com.hiddify.hiddify.utils.CommandClient
import com.hiddify.hiddify.utils.ParsedOutboundGroup
import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.plugin.common.EventChannel
import io.nekohasekai.libbox.OutboundGroup
import kotlinx.coroutines.CoroutineScope
class ActiveGroupsChannel(private val scope: CoroutineScope) : FlutterPlugin,
CommandClient.Handler {
companion object {
const val TAG = "A/ActiveGroupsChannel"
const val CHANNEL = "com.baer.app/active-groups"
val gson = Gson()
}
private val client =
CommandClient(scope, CommandClient.ConnectionType.GroupOnly, this)
private var channel: EventChannel? = null
private var event: EventChannel.EventSink? = null
override fun updateGroups(groups: List<OutboundGroup>) {
MainActivity.instance.runOnUiThread {
val parsedGroups = groups.map { group -> ParsedOutboundGroup.fromOutbound(group) }
event?.success(gson.toJson(parsedGroups))
}
}
override fun onAttachedToEngine(flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
channel = EventChannel(
flutterPluginBinding.binaryMessenger,
CHANNEL
)
channel!!.setStreamHandler(object : EventChannel.StreamHandler {
override fun onListen(arguments: Any?, events: EventChannel.EventSink?) {
event = events
Log.d(TAG, "connecting active groups command client")
client.connect()
}
override fun onCancel(arguments: Any?) {
event = null
Log.d(TAG, "disconnecting active groups command client")
client.disconnect()
}
})
}
override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
event = null
client.disconnect()
channel?.setStreamHandler(null)
}
}

43
android/app/src/main/kotlin/com/hiddify/hiddify/Application.kt Executable file
View File

@ -0,0 +1,43 @@
package com.hiddify.hiddify
import android.app.Application
import android.app.NotificationManager
import android.content.Context
import android.content.Intent
import android.content.IntentFilter
import android.net.ConnectivityManager
import android.os.PowerManager
import androidx.core.content.getSystemService
import com.hiddify.hiddify.bg.AppChangeReceiver
import go.Seq
import com.hiddify.hiddify.Application as BoxApplication
class Application : Application() {
override fun attachBaseContext(base: Context?) {
super.attachBaseContext(base)
application = this
}
override fun onCreate() {
super.onCreate()
Seq.setContext(this)
registerReceiver(AppChangeReceiver(), IntentFilter().apply {
addAction(Intent.ACTION_PACKAGE_ADDED)
addDataScheme("package")
})
}
companion object {
lateinit var application: BoxApplication
val notification by lazy { application.getSystemService<NotificationManager>()!! }
val connectivity by lazy { application.getSystemService<ConnectivityManager>()!! }
val packageManager by lazy { application.packageManager }
val powerManager by lazy { application.getSystemService<PowerManager>()!! }
val notificationManager by lazy { application.getSystemService<NotificationManager>()!! }
}
}

82
android/app/src/main/kotlin/com/hiddify/hiddify/EventHandler.kt Executable file
View File

@ -0,0 +1,82 @@
package com.hiddify.hiddify
import android.util.Log
import androidx.lifecycle.Observer
import com.hiddify.hiddify.constant.Alert
import com.hiddify.hiddify.constant.Status
import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.plugin.common.EventChannel
import io.flutter.plugin.common.JSONMethodCodec
class EventHandler : FlutterPlugin {
companion object {
const val TAG = "A/EventHandler"
const val SERVICE_STATUS = "com.baer.app/service.status"
const val SERVICE_ALERTS = "com.baer.app/service.alerts"
}
private var statusChannel: EventChannel? = null
private var alertsChannel: EventChannel? = null
private var statusObserver: Observer<Status>? = null
private var alertsObserver: Observer<ServiceEvent?>? = null
override fun onAttachedToEngine(flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
statusChannel = EventChannel(flutterPluginBinding.binaryMessenger, SERVICE_STATUS, JSONMethodCodec.INSTANCE)
alertsChannel = EventChannel(flutterPluginBinding.binaryMessenger, SERVICE_ALERTS, JSONMethodCodec.INSTANCE)
statusChannel!!.setStreamHandler(object : EventChannel.StreamHandler {
override fun onListen(arguments: Any?, events: EventChannel.EventSink?) {
statusObserver = Observer {
Log.d(TAG, "new status: $it")
val map = listOf(
Pair("status", it.name)
)
.toMap()
events?.success(map)
}
MainActivity.instance.serviceStatus.observeForever(statusObserver!!)
}
override fun onCancel(arguments: Any?) {
if (statusObserver != null)
MainActivity.instance.serviceStatus.removeObserver(statusObserver!!)
}
})
alertsChannel!!.setStreamHandler(object : EventChannel.StreamHandler {
override fun onListen(arguments: Any?, events: EventChannel.EventSink?) {
alertsObserver = Observer {
if (it == null) return@Observer
Log.d(TAG, "new alert: $it")
val map = listOf(
Pair("status", it.status.name),
Pair("alert", it.alert?.name),
Pair("message", it.message)
)
.mapNotNull { p -> p.second?.let { Pair(p.first, p.second) } }
.toMap()
events?.success(map)
}
MainActivity.instance.serviceAlerts.observeForever(alertsObserver!!)
}
override fun onCancel(arguments: Any?) {
if (alertsObserver != null)
MainActivity.instance.serviceAlerts.removeObserver(alertsObserver!!)
}
})
}
override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
if (statusObserver != null)
MainActivity.instance.serviceStatus.removeObserver(statusObserver!!)
statusChannel?.setStreamHandler(null)
if (alertsObserver != null)
MainActivity.instance.serviceAlerts.removeObserver(alertsObserver!!)
alertsChannel?.setStreamHandler(null)
}
}
data class ServiceEvent(val status: Status, val alert: Alert? = null, val message: String? = null)

58
android/app/src/main/kotlin/com/hiddify/hiddify/GroupsChannel.kt Executable file
View File

@ -0,0 +1,58 @@
package com.hiddify.hiddify
import android.util.Log
import com.google.gson.Gson
import com.hiddify.hiddify.utils.CommandClient
import com.hiddify.hiddify.utils.ParsedOutboundGroup
import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.plugin.common.EventChannel
import io.nekohasekai.libbox.OutboundGroup
import kotlinx.coroutines.CoroutineScope
class GroupsChannel(private val scope: CoroutineScope) : FlutterPlugin, CommandClient.Handler {
companion object {
const val TAG = "A/GroupsChannel"
const val CHANNEL = "com.baer.app/groups"
val gson = Gson()
}
private val client =
CommandClient(scope, CommandClient.ConnectionType.Groups, this)
private var channel: EventChannel? = null
private var event: EventChannel.EventSink? = null
override fun updateGroups(groups: List<OutboundGroup>) {
MainActivity.instance.runOnUiThread {
val parsedGroups = groups.map { group -> ParsedOutboundGroup.fromOutbound(group) }
event?.success(gson.toJson(parsedGroups))
}
}
override fun onAttachedToEngine(flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
channel = EventChannel(
flutterPluginBinding.binaryMessenger,
CHANNEL
)
channel!!.setStreamHandler(object : EventChannel.StreamHandler {
override fun onListen(arguments: Any?, events: EventChannel.EventSink?) {
event = events
Log.d(TAG, "connecting groups command client")
client.connect()
}
override fun onCancel(arguments: Any?) {
event = null
Log.d(TAG, "disconnecting groups command client")
client.disconnect()
}
})
}
override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
event = null
client.disconnect()
channel?.setStreamHandler(null)
}
}

37
android/app/src/main/kotlin/com/hiddify/hiddify/LogHandler.kt Executable file
View File

@ -0,0 +1,37 @@
package com.hiddify.hiddify
import android.util.Log
import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.plugin.common.EventChannel
class LogHandler : FlutterPlugin {
companion object {
const val TAG = "A/LogHandler"
const val SERVICE_LOGS = "com.baer.app/service.logs"
}
private lateinit var logsChannel: EventChannel
override fun onAttachedToEngine(flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
logsChannel = EventChannel(flutterPluginBinding.binaryMessenger, SERVICE_LOGS)
logsChannel.setStreamHandler(object : EventChannel.StreamHandler {
override fun onListen(arguments: Any?, events: EventChannel.EventSink?) {
val activity = MainActivity.instance
events?.success(activity.logList)
activity.logCallback = {
events?.success(activity.logList)
}
}
override fun onCancel(arguments: Any?) {
MainActivity.instance.logCallback = null
}
})
}
override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
}
}

156
android/app/src/main/kotlin/com/hiddify/hiddify/MainActivity.kt Executable file
View File

@ -0,0 +1,156 @@
package com.hiddify.hiddify
import android.annotation.SuppressLint
import android.content.Intent
import android.Manifest
import android.content.pm.PackageManager
import android.net.VpnService
import android.os.Build
import android.util.Log
import androidx.core.app.ActivityCompat
import androidx.core.content.ContextCompat
import androidx.lifecycle.MutableLiveData
import androidx.lifecycle.lifecycleScope
import com.hiddify.hiddify.bg.ServiceConnection
import com.hiddify.hiddify.bg.ServiceNotification
import com.hiddify.hiddify.constant.Alert
import com.hiddify.hiddify.constant.ServiceMode
import com.hiddify.hiddify.constant.Status
import io.flutter.embedding.android.FlutterFragmentActivity
import io.flutter.embedding.engine.FlutterEngine
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
import kotlinx.coroutines.withContext
import java.util.LinkedList
class MainActivity : FlutterFragmentActivity(), ServiceConnection.Callback {
companion object {
private const val TAG = "ANDROID/MyActivity"
lateinit var instance: MainActivity
const val VPN_PERMISSION_REQUEST_CODE = 1001
const val NOTIFICATION_PERMISSION_REQUEST_CODE = 1010
}
private val connection = ServiceConnection(this, this)
val logList = LinkedList<String>()
var logCallback: ((Boolean) -> Unit)? = null
val serviceStatus = MutableLiveData(Status.Stopped)
val serviceAlerts = MutableLiveData<ServiceEvent?>(null)
override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
super.configureFlutterEngine(flutterEngine)
instance = this
reconnect()
flutterEngine.plugins.add(MethodHandler(lifecycleScope))
flutterEngine.plugins.add(PlatformSettingsHandler())
flutterEngine.plugins.add(EventHandler())
flutterEngine.plugins.add(LogHandler())
flutterEngine.plugins.add(GroupsChannel(lifecycleScope))
flutterEngine.plugins.add(ActiveGroupsChannel(lifecycleScope))
flutterEngine.plugins.add(StatsChannel(lifecycleScope))
}
fun reconnect() {
connection.reconnect()
}
fun startService() {
// 暂时跳过通知权限检查
lifecycleScope.launch(Dispatchers.IO) {
if (Settings.rebuildServiceMode()) {
reconnect()
}
if (Settings.serviceMode == ServiceMode.VPN) {
if (prepare()) {
Log.d(TAG, "VPN permission required")
return@launch
}
}
val intent = Intent(Application.application, Settings.serviceClass())
withContext(Dispatchers.Main) {
ContextCompat.startForegroundService(Application.application, intent)
}
}
}
private suspend fun prepare() = withContext(Dispatchers.Main) {
try {
val intent = VpnService.prepare(this@MainActivity)
if (intent != null) {
startActivityForResult(intent, VPN_PERMISSION_REQUEST_CODE)
true
} else {
false
}
} catch (e: Exception) {
onServiceAlert(Alert.RequestVPNPermission, e.message)
false
}
}
override fun onServiceStatusChanged(status: Status) {
serviceStatus.postValue(status)
}
override fun onServiceAlert(type: Alert, message: String?) {
serviceAlerts.postValue(ServiceEvent(Status.Stopped, type, message))
}
override fun onServiceWriteLog(message: String?) {
if (logList.size > 300) {
logList.removeFirst()
}
logList.addLast(message ?: "")
logCallback?.invoke(false)
}
override fun onServiceResetLogs(messages: MutableList<String>) {
logList.clear()
logList.addAll(messages)
logCallback?.invoke(true)
}
override fun onDestroy() {
connection.disconnect()
super.onDestroy()
}
@SuppressLint("NewApi")
private fun grantNotificationPermission() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
ActivityCompat.requestPermissions(
this,
arrayOf(Manifest.permission.POST_NOTIFICATIONS),
NOTIFICATION_PERMISSION_REQUEST_CODE
)
}
}
override fun onRequestPermissionsResult(
requestCode: Int,
permissions: Array<out String>,
grantResults: IntArray
) {
if (requestCode == NOTIFICATION_PERMISSION_REQUEST_CODE) {
if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
startService()
} else onServiceAlert(Alert.RequestNotificationPermission, null)
}
super.onRequestPermissionsResult(requestCode, permissions, grantResults)
}
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == VPN_PERMISSION_REQUEST_CODE) {
if (resultCode == RESULT_OK) startService()
else onServiceAlert(Alert.RequestVPNPermission, null)
} else if (requestCode == NOTIFICATION_PERMISSION_REQUEST_CODE) {
if (resultCode == RESULT_OK) startService()
else onServiceAlert(Alert.RequestNotificationPermission, null)
}
}
}

227
android/app/src/main/kotlin/com/hiddify/hiddify/MethodHandler.kt Executable file
View File

@ -0,0 +1,227 @@
package com.hiddify.hiddify
import android.util.Log
import com.hiddify.hiddify.bg.BoxService
import com.hiddify.hiddify.constant.Status
import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.plugin.common.MethodCall
import io.flutter.plugin.common.MethodChannel
import io.nekohasekai.libbox.Libbox
import io.nekohasekai.mobile.Mobile
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.delay
import kotlinx.coroutines.launch
import java.io.File
class MethodHandler(private val scope: CoroutineScope) : FlutterPlugin,
MethodChannel.MethodCallHandler {
private var channel: MethodChannel? = null
companion object {
const val TAG = "A/MethodHandler"
const val channelName = "com.baer.app/method"
enum class Trigger(val method: String) {
Setup("setup"),
ParseConfig("parse_config"),
changeHiddifyOptions("change_hiddify_options"),
GenerateConfig("generate_config"),
Start("start"),
Stop("stop"),
Restart("restart"),
SelectOutbound("select_outbound"),
UrlTest("url_test"),
ClearLogs("clear_logs"),
GenerateWarpConfig("generate_warp_config"),
}
}
override fun onAttachedToEngine(flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
channel = MethodChannel(
flutterPluginBinding.binaryMessenger,
channelName,
)
channel!!.setMethodCallHandler(this)
}
override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
channel?.setMethodCallHandler(null)
}
override fun onMethodCall(call: MethodCall, result: MethodChannel.Result) {
when (call.method) {
Trigger.Setup.method -> {
GlobalScope.launch {
result.runCatching {
val baseDir = Application.application.filesDir
baseDir.mkdirs()
val workingDir = Application.application.getExternalFilesDir(null)
workingDir?.mkdirs()
val tempDir = Application.application.cacheDir
tempDir.mkdirs()
Log.d(TAG, "base dir: ${baseDir.path}")
Log.d(TAG, "working dir: ${workingDir?.path}")
Log.d(TAG, "temp dir: ${tempDir.path}")
Mobile.setup(baseDir.path, workingDir?.path, tempDir.path, false)
Libbox.redirectStderr(File(workingDir, "stderr2.log").path)
success("")
}
}
}
Trigger.ParseConfig.method -> {
scope.launch(Dispatchers.IO) {
result.runCatching {
val args = call.arguments as Map<*, *>
val path = args["path"] as String
val tempPath = args["tempPath"] as String
val debug = args["debug"] as Boolean
val msg = BoxService.parseConfig(path, tempPath, debug)
success(msg)
}
}
}
Trigger.changeHiddifyOptions.method -> {
scope.launch {
result.runCatching {
val args = call.arguments as String
Settings.configOptions = args
success(true)
}
}
}
Trigger.GenerateConfig.method -> {
scope.launch {
result.runCatching {
val args = call.arguments as Map<*, *>
val path = args["path"] as String
val options = Settings.configOptions
if (options.isBlank() || path.isBlank()) {
error("blank properties")
}
val config = BoxService.buildConfig(path, options)
success(config)
}
}
}
Trigger.Start.method -> {
scope.launch {
result.runCatching {
val args = call.arguments as Map<*, *>
Settings.activeConfigPath = args["path"] as String? ?: ""
Settings.activeProfileName = args["name"] as String? ?: ""
val mainActivity = MainActivity.instance
val started = mainActivity.serviceStatus.value == Status.Started
if (started) {
Log.w(TAG, "service is already running")
return@launch success(true)
}
mainActivity.startService()
success(true)
}
}
}
Trigger.Stop.method -> {
scope.launch {
result.runCatching {
val mainActivity = MainActivity.instance
val started = mainActivity.serviceStatus.value == Status.Started
if (!started) {
Log.w(TAG, "service is not running")
return@launch success(true)
}
BoxService.stop()
success(true)
}
}
}
Trigger.Restart.method -> {
scope.launch(Dispatchers.IO) {
result.runCatching {
val args = call.arguments as Map<*, *>
Settings.activeConfigPath = args["path"] as String? ?: ""
Settings.activeProfileName = args["name"] as String? ?: ""
val mainActivity = MainActivity.instance
val started = mainActivity.serviceStatus.value == Status.Started
if (!started) return@launch success(true)
val restart = Settings.rebuildServiceMode()
if (restart) {
mainActivity.reconnect()
BoxService.stop()
delay(1000L)
mainActivity.startService()
return@launch success(true)
}
runCatching {
Libbox.newStandaloneCommandClient().serviceReload()
success(true)
}.onFailure {
error(it)
}
}
}
}
Trigger.SelectOutbound.method -> {
scope.launch {
result.runCatching {
val args = call.arguments as Map<*, *>
Libbox.newStandaloneCommandClient()
.selectOutbound(
args["groupTag"] as String,
args["outboundTag"] as String
)
success(true)
}
}
}
Trigger.UrlTest.method -> {
scope.launch {
result.runCatching {
val args = call.arguments as Map<*, *>
Libbox.newStandaloneCommandClient()
.urlTest(
args["groupTag"] as String
)
success(true)
}
}
}
Trigger.ClearLogs.method -> {
scope.launch {
result.runCatching {
MainActivity.instance.onServiceResetLogs(mutableListOf())
success(true)
}
}
}
Trigger.GenerateWarpConfig.method -> {
scope.launch(Dispatchers.IO) {
result.runCatching {
val args = call.arguments as Map<*, *>
val warpConfig = Mobile.generateWarpConfig(
args["license-key"] as String,
args["previous-account-id"] as String,
args["previous-access-token"] as String,
)
success(warpConfig)
}
}
}
else -> result.notImplemented()
}
}
}

189
android/app/src/main/kotlin/com/hiddify/hiddify/PlatformSettingsHandler.kt Executable file
View File

@ -0,0 +1,189 @@
package com.hiddify.hiddify
import android.Manifest
import android.annotation.SuppressLint
import android.app.Activity
import android.content.Intent
import android.content.pm.ApplicationInfo
import android.content.pm.PackageManager
import android.graphics.Bitmap
import android.graphics.Canvas
import android.net.Uri
import android.os.Build
import android.util.Base64
import com.google.gson.Gson
import com.google.gson.annotations.SerializedName
import com.hiddify.hiddify.Application.Companion.packageManager
import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.embedding.engine.plugins.activity.ActivityAware
import io.flutter.embedding.engine.plugins.activity.ActivityPluginBinding
import io.flutter.plugin.common.MethodCall
import io.flutter.plugin.common.MethodChannel
import io.flutter.plugin.common.PluginRegistry
import io.flutter.plugin.common.StandardMethodCodec
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch
import java.io.ByteArrayOutputStream
class PlatformSettingsHandler : FlutterPlugin, MethodChannel.MethodCallHandler, ActivityAware,
PluginRegistry.ActivityResultListener {
private var channel: MethodChannel? = null
private var activity: Activity? = null
private lateinit var ignoreRequestResult: MethodChannel.Result
companion object {
const val channelName = "com.baer.app/platform"
const val REQUEST_IGNORE_BATTERY_OPTIMIZATIONS = 44
val gson = Gson()
enum class Trigger(val method: String) {
IsIgnoringBatteryOptimizations("is_ignoring_battery_optimizations"),
RequestIgnoreBatteryOptimizations("request_ignore_battery_optimizations"),
GetInstalledPackages("get_installed_packages"),
GetPackagesIcon("get_package_icon"),
}
}
override fun onAttachedToEngine(flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
val taskQueue = flutterPluginBinding.binaryMessenger.makeBackgroundTaskQueue()
channel = MethodChannel(
flutterPluginBinding.binaryMessenger,
channelName,
StandardMethodCodec.INSTANCE,
taskQueue
)
channel!!.setMethodCallHandler(this)
}
override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
channel?.setMethodCallHandler(null)
}
override fun onAttachedToActivity(binding: ActivityPluginBinding) {
activity = binding.activity
binding.addActivityResultListener(this)
}
override fun onDetachedFromActivityForConfigChanges() {
activity = null
}
override fun onReattachedToActivityForConfigChanges(binding: ActivityPluginBinding) {
activity = binding.activity
binding.addActivityResultListener(this)
}
override fun onDetachedFromActivity() {
activity = null
}
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?): Boolean {
if (requestCode == REQUEST_IGNORE_BATTERY_OPTIMIZATIONS) {
ignoreRequestResult.success(resultCode == Activity.RESULT_OK)
return true
}
return false
}
data class AppItem(
@SerializedName("package-name") val packageName: String,
@SerializedName("name") val name: String,
@SerializedName("is-system-app") val isSystemApp: Boolean
)
@SuppressLint("BatteryLife")
override fun onMethodCall(call: MethodCall, result: MethodChannel.Result) {
when (call.method) {
Trigger.IsIgnoringBatteryOptimizations.method -> {
result.runCatching {
success(
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
Application.powerManager.isIgnoringBatteryOptimizations(Application.application.packageName)
} else {
true
}
)
}
}
Trigger.RequestIgnoreBatteryOptimizations.method -> {
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
return result.success(true)
}
val intent = Intent(
android.provider.Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS,
Uri.parse("package:${Application.application.packageName}")
)
ignoreRequestResult = result
activity?.startActivityForResult(intent, REQUEST_IGNORE_BATTERY_OPTIMIZATIONS)
}
Trigger.GetInstalledPackages.method -> {
GlobalScope.launch {
result.runCatching {
val flag = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
PackageManager.GET_PERMISSIONS or PackageManager.MATCH_UNINSTALLED_PACKAGES
} else {
@Suppress("DEPRECATION")
PackageManager.GET_PERMISSIONS or PackageManager.GET_UNINSTALLED_PACKAGES
}
val installedPackages =
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
packageManager.getInstalledPackages(
PackageManager.PackageInfoFlags.of(
flag.toLong()
)
)
} else {
@Suppress("DEPRECATION")
packageManager.getInstalledPackages(flag)
}
val list = mutableListOf<AppItem>()
installedPackages.forEach {
if (it.packageName != Application.application.packageName &&
(it.requestedPermissions?.contains(Manifest.permission.INTERNET) == true
|| it.packageName == "android")
) {
list.add(
AppItem(
it.packageName,
it.applicationInfo?.loadLabel(packageManager)?.toString() ?: "",
(it.applicationInfo?.flags ?: 0) and ApplicationInfo.FLAG_SYSTEM == 1
)
)
}
}
list.sortBy { it.name }
success(gson.toJson(list))
}
}
}
Trigger.GetPackagesIcon.method -> {
result.runCatching {
val args = call.arguments as Map<*, *>
val packageName =
args["packageName"] as String
val drawable = packageManager.getApplicationIcon(packageName)
val bitmap = Bitmap.createBitmap(
drawable.intrinsicWidth,
drawable.intrinsicHeight,
Bitmap.Config.ARGB_8888
)
val canvas = Canvas(bitmap)
drawable.setBounds(0, 0, canvas.width, canvas.height)
drawable.draw(canvas)
val byteArrayOutputStream = ByteArrayOutputStream()
bitmap.compress(Bitmap.CompressFormat.PNG, 100, byteArrayOutputStream)
val base64: String =
Base64.encodeToString(byteArrayOutputStream.toByteArray(), Base64.NO_WRAP)
success(base64)
}
}
else -> result.notImplemented()
}
}
}

126
android/app/src/main/kotlin/com/hiddify/hiddify/Settings.kt Executable file
View File

@ -0,0 +1,126 @@
package com.hiddify.hiddify
import android.content.Context
import android.util.Base64
import com.hiddify.hiddify.bg.ProxyService
import com.hiddify.hiddify.bg.VPNService
import com.hiddify.hiddify.constant.PerAppProxyMode
import com.hiddify.hiddify.constant.ServiceMode
import com.hiddify.hiddify.constant.SettingsKey
import org.json.JSONObject
import java.io.ByteArrayInputStream
import java.io.File
import java.io.ObjectInputStream
object Settings {
private val preferences by lazy {
val context = Application.application.applicationContext
context.getSharedPreferences("FlutterSharedPreferences", Context.MODE_PRIVATE)
}
private const val LIST_IDENTIFIER = "VGhpcyBpcyB0aGUgcHJlZml4IGZvciBhIGxpc3Qu"
var perAppProxyMode: String
get() = preferences.getString(SettingsKey.PER_APP_PROXY_MODE, PerAppProxyMode.OFF)!!
set(value) = preferences.edit().putString(SettingsKey.PER_APP_PROXY_MODE, value).apply()
val perAppProxyEnabled: Boolean
get() = perAppProxyMode != PerAppProxyMode.OFF
val perAppProxyList: List<String>
get() {
val stringValue = if (perAppProxyMode == PerAppProxyMode.INCLUDE) {
preferences.getString(SettingsKey.PER_APP_PROXY_INCLUDE_LIST, "")!!
} else {
preferences.getString(SettingsKey.PER_APP_PROXY_EXCLUDE_LIST, "")!!
}
if (!stringValue.startsWith(LIST_IDENTIFIER)) {
return emptyList()
}
return decodeListString(stringValue.substring(LIST_IDENTIFIER.length))
}
private fun decodeListString(listString: String): List<String> {
val stream = ObjectInputStream(ByteArrayInputStream(Base64.decode(listString, 0)))
return stream.readObject() as List<String>
}
var activeConfigPath: String
get() = preferences.getString(SettingsKey.ACTIVE_CONFIG_PATH, "")!!
set(value) = preferences.edit().putString(SettingsKey.ACTIVE_CONFIG_PATH, value).apply()
var activeProfileName: String
get() = preferences.getString(SettingsKey.ACTIVE_PROFILE_NAME, "")!!
set(value) = preferences.edit().putString(SettingsKey.ACTIVE_PROFILE_NAME, value).apply()
var serviceMode: String
get() = preferences.getString(SettingsKey.SERVICE_MODE, ServiceMode.VPN)!!
set(value) = preferences.edit().putString(SettingsKey.SERVICE_MODE, value).apply()
var configOptions: String
get() = preferences.getString(SettingsKey.CONFIG_OPTIONS, "")!!
set(value) = preferences.edit().putString(SettingsKey.CONFIG_OPTIONS, value).apply()
var debugMode: Boolean
get() = preferences.getBoolean(SettingsKey.DEBUG_MODE, false)
set(value) = preferences.edit().putBoolean(SettingsKey.DEBUG_MODE, value).apply()
var disableMemoryLimit: Boolean
get() = preferences.getBoolean(SettingsKey.DISABLE_MEMORY_LIMIT, false)
set(value) =
preferences.edit().putBoolean(SettingsKey.DISABLE_MEMORY_LIMIT, value).apply()
var dynamicNotification: Boolean
get() = preferences.getBoolean(SettingsKey.DYNAMIC_NOTIFICATION, true)
set(value) =
preferences.edit().putBoolean(SettingsKey.DYNAMIC_NOTIFICATION, value).apply()
var systemProxyEnabled: Boolean
get() = preferences.getBoolean(SettingsKey.SYSTEM_PROXY_ENABLED, true)
set(value) =
preferences.edit().putBoolean(SettingsKey.SYSTEM_PROXY_ENABLED, value).apply()
var startedByUser: Boolean
get() = preferences.getBoolean(SettingsKey.STARTED_BY_USER, false)
set(value) = preferences.edit().putBoolean(SettingsKey.STARTED_BY_USER, value).apply()
fun serviceClass(): Class<*> {
return when (serviceMode) {
ServiceMode.VPN -> VPNService::class.java
else -> ProxyService::class.java
}
}
private var currentServiceMode : String? = null
suspend fun rebuildServiceMode(): Boolean {
var newMode = ServiceMode.NORMAL
try {
if (serviceMode == ServiceMode.VPN) {
newMode = ServiceMode.VPN
}
} catch (_: Exception) {
}
if (currentServiceMode == newMode) {
return false
}
currentServiceMode = newMode
return true
}
private suspend fun needVPNService(): Boolean {
val filePath = activeConfigPath
if (filePath.isBlank()) return false
val content = JSONObject(File(filePath).readText())
val inbounds = content.getJSONArray("inbounds")
for (index in 0 until inbounds.length()) {
val inbound = inbounds.getJSONObject(index)
if (inbound.getString("type") == "tun") {
return true
}
}
return false
}
}

67
android/app/src/main/kotlin/com/hiddify/hiddify/ShortcutActivity.kt Executable file
View File

@ -0,0 +1,67 @@
package com.hiddify.hiddify
import android.app.Activity
import android.content.Intent
import android.content.pm.ShortcutManager
import android.os.Build
import android.os.Bundle
import androidx.core.content.getSystemService
import androidx.core.content.pm.ShortcutInfoCompat
import androidx.core.content.pm.ShortcutManagerCompat
import androidx.core.graphics.drawable.IconCompat
import com.hiddify.hiddify.bg.BoxService
import com.hiddify.hiddify.bg.ServiceConnection
import com.hiddify.hiddify.constant.Status
class ShortcutActivity : Activity(), ServiceConnection.Callback {
private val connection = ServiceConnection(this, this, false)
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
if (intent.action == Intent.ACTION_CREATE_SHORTCUT) {
setResult(
RESULT_OK, ShortcutManagerCompat.createShortcutResultIntent(
this,
ShortcutInfoCompat.Builder(this, "toggle")
.setIntent(
Intent(
this,
ShortcutActivity::class.java
).setAction(Intent.ACTION_MAIN)
)
.setIcon(
IconCompat.createWithResource(
this,
R.mipmap.ic_launcher
)
)
.setShortLabel(getString(R.string.quick_toggle))
.build()
)
)
finish()
} else {
connection.connect()
if (Build.VERSION.SDK_INT >= 25) {
getSystemService<ShortcutManager>()?.reportShortcutUsed("toggle")
}
}
moveTaskToBack(true)
}
override fun onServiceStatusChanged(status: Status) {
when (status) {
Status.Started -> BoxService.stop()
Status.Stopped -> BoxService.start()
else -> {}
}
finish()
}
override fun onDestroy() {
connection.disconnect()
super.onDestroy()
}
}

64
android/app/src/main/kotlin/com/hiddify/hiddify/StatsChannel.kt Executable file
View File

@ -0,0 +1,64 @@
package com.hiddify.hiddify
import android.util.Log
import com.hiddify.hiddify.utils.CommandClient
import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.plugin.common.EventChannel
import io.flutter.plugin.common.JSONMethodCodec
import io.nekohasekai.libbox.StatusMessage
import kotlinx.coroutines.CoroutineScope
class StatsChannel(private val scope: CoroutineScope) : FlutterPlugin, CommandClient.Handler{
companion object {
const val TAG = "A/StatsChannel"
const val STATS_CHANNEL = "com.baer.app/stats"
}
private val commandClient =
CommandClient(scope, CommandClient.ConnectionType.Status, this)
private var statsChannel: EventChannel? = null
private var statsEvent: EventChannel.EventSink? = null
override fun updateStatus(status: StatusMessage) {
MainActivity.instance.runOnUiThread {
val map = listOf(
Pair("connections-in", status.connectionsIn),
Pair("connections-out", status.connectionsOut),
Pair("uplink", status.uplink),
Pair("downlink", status.downlink),
Pair("uplink-total", status.uplinkTotal),
Pair("downlink-total", status.downlinkTotal)
).associate { it.first to it.second }
statsEvent?.success(map)
}
}
override fun onAttachedToEngine(flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
statsChannel = EventChannel(
flutterPluginBinding.binaryMessenger,
STATS_CHANNEL,
JSONMethodCodec.INSTANCE
)
statsChannel!!.setStreamHandler(object : EventChannel.StreamHandler {
override fun onListen(arguments: Any?, events: EventChannel.EventSink?) {
statsEvent = events
Log.d(TAG, "connecting stats command client")
commandClient.connect()
}
override fun onCancel(arguments: Any?) {
statsEvent = null
Log.d(TAG, "disconnecting stats command client")
commandClient.disconnect()
}
})
}
override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
statsEvent = null
commandClient.disconnect()
statsChannel?.setStreamHandler(null)
}
}

37
android/app/src/main/kotlin/com/hiddify/hiddify/bg/AppChangeReceiver.kt Executable file
View File

@ -0,0 +1,37 @@
package com.hiddify.hiddify.bg
import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import com.hiddify.hiddify.Settings
class AppChangeReceiver : BroadcastReceiver() {
companion object {
private const val TAG = "A/AppChangeReceiver"
}
override fun onReceive(context: Context, intent: Intent) {
checkUpdate(context, intent)
}
private fun checkUpdate(context: Context, intent: Intent) {
// if (!Settings.perAppProxyEnabled) {
// return
// }
// val perAppProxyUpdateOnChange = Settings.perAppProxyUpdateOnChange
// if (perAppProxyUpdateOnChange == Settings.PER_APP_PROXY_DISABLED) {
// return
// }
// val packageName = intent.dataString?.substringAfter("package:")
// if (packageName.isNullOrBlank()) {
// return
// }
// if ((perAppProxyUpdateOnChange == Settings.PER_APP_PROXY_INCLUDE)) {
// Settings.perAppProxyList = Settings.perAppProxyList + packageName
// } else {
// Settings.perAppProxyList = Settings.perAppProxyList - packageName
// }
}
}

30
android/app/src/main/kotlin/com/hiddify/hiddify/bg/BootReceiver.kt Executable file
View File

@ -0,0 +1,30 @@
package com.hiddify.hiddify.bg
import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import com.hiddify.hiddify.Settings
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch
import kotlinx.coroutines.withContext
class BootReceiver : BroadcastReceiver() {
override fun onReceive(context: Context, intent: Intent) {
when (intent.action) {
Intent.ACTION_BOOT_COMPLETED, Intent.ACTION_MY_PACKAGE_REPLACED -> {
}
else -> return
}
GlobalScope.launch(Dispatchers.IO) {
if (Settings.startedByUser) {
withContext(Dispatchers.Main) {
BoxService.start()
}
}
}
}
}

364
android/app/src/main/kotlin/com/hiddify/hiddify/bg/BoxService.kt Executable file
View File

@ -0,0 +1,364 @@
package com.hiddify.hiddify.bg
import android.app.Service
import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import android.content.IntentFilter
import android.os.Build
import android.os.IBinder
import android.os.ParcelFileDescriptor
import android.os.PowerManager
import android.util.Log
import androidx.annotation.RequiresApi
import androidx.core.content.ContextCompat
import androidx.lifecycle.MutableLiveData
import com.hiddify.hiddify.Application
import com.hiddify.hiddify.R
import com.hiddify.hiddify.Settings
import com.hiddify.hiddify.constant.Action
import com.hiddify.hiddify.constant.Alert
import com.hiddify.hiddify.constant.Status
import go.Seq
import io.nekohasekai.libbox.BoxService
import io.nekohasekai.libbox.CommandServer
import io.nekohasekai.libbox.CommandServerHandler
import io.nekohasekai.libbox.Libbox
import io.nekohasekai.libbox.PlatformInterface
import io.nekohasekai.libbox.SystemProxyStatus
import io.nekohasekai.mobile.Mobile
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.delay
import kotlinx.coroutines.launch
import kotlinx.coroutines.runBlocking
import kotlinx.coroutines.withContext
import java.io.File
class BoxService(
private val service: Service,
private val platformInterface: PlatformInterface
) : CommandServerHandler {
companion object {
private const val TAG = "A/BoxService"
private var initializeOnce = false
private lateinit var workingDir: File
private fun initialize() {
if (initializeOnce) return
val baseDir = Application.application.filesDir
baseDir.mkdirs()
workingDir = Application.application.getExternalFilesDir(null) ?: return
workingDir.mkdirs()
val tempDir = Application.application.cacheDir
tempDir.mkdirs()
Log.d(TAG, "base dir: ${baseDir.path}")
Log.d(TAG, "working dir: ${workingDir.path}")
Log.d(TAG, "temp dir: ${tempDir.path}")
Mobile.setup(baseDir.path, workingDir.path, tempDir.path, false)
Libbox.redirectStderr(File(workingDir, "stderr.log").path)
initializeOnce = true
return
}
fun parseConfig(path: String, tempPath: String, debug: Boolean): String {
return try {
Mobile.parse(path, tempPath, debug)
""
} catch (e: Exception) {
Log.w(TAG, e)
e.message ?: "invalid config"
}
}
fun buildConfig(path: String, options: String): String {
return Mobile.buildConfig(path, options)
}
fun start() {
val intent = runBlocking {
withContext(Dispatchers.IO) {
Intent(Application.application, Settings.serviceClass())
}
}
ContextCompat.startForegroundService(Application.application, intent)
}
fun stop() {
Application.application.sendBroadcast(
Intent(Action.SERVICE_CLOSE).setPackage(
Application.application.packageName
)
)
}
fun reload() {
Application.application.sendBroadcast(
Intent(Action.SERVICE_RELOAD).setPackage(
Application.application.packageName
)
)
}
}
var fileDescriptor: ParcelFileDescriptor? = null
private val status = MutableLiveData(Status.Stopped)
private val binder = ServiceBinder(status)
private val notification = ServiceNotification(status, service)
private var boxService: BoxService? = null
private var commandServer: CommandServer? = null
private var receiverRegistered = false
private val receiver = object : BroadcastReceiver() {
override fun onReceive(context: Context, intent: Intent) {
when (intent.action) {
Action.SERVICE_CLOSE -> {
stopService()
}
Action.SERVICE_RELOAD -> {
serviceReload()
}
PowerManager.ACTION_DEVICE_IDLE_MODE_CHANGED -> {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
serviceUpdateIdleMode()
}
}
}
}
}
private fun startCommandServer() {
val commandServer =
CommandServer(this, 300)
commandServer.start()
this.commandServer = commandServer
}
private var activeProfileName = ""
private suspend fun startService(delayStart: Boolean = false) {
try {
Log.d(TAG, "starting service")
// 暂时禁用通知显示
// withContext(Dispatchers.Main) {
// notification.show(activeProfileName, R.string.status_starting)
// }
val selectedConfigPath = Settings.activeConfigPath
if (selectedConfigPath.isBlank()) {
stopAndAlert(Alert.EmptyConfiguration)
return
}
activeProfileName = Settings.activeProfileName
val configOptions = Settings.configOptions
if (configOptions.isBlank()) {
stopAndAlert(Alert.EmptyConfiguration)
return
}
val content = try {
Mobile.buildConfig(selectedConfigPath, configOptions)
} catch (e: Exception) {
Log.w(TAG, e)
stopAndAlert(Alert.EmptyConfiguration)
return
}
if (Settings.debugMode) {
File(workingDir, "current-config.json").writeText(content)
}
withContext(Dispatchers.Main) {
notification.show(activeProfileName, R.string.status_starting)
binder.broadcast {
it.onServiceResetLogs(listOf())
}
}
DefaultNetworkMonitor.start()
Libbox.registerLocalDNSTransport(LocalResolver)
Libbox.setMemoryLimit(!Settings.disableMemoryLimit)
val newService = try {
Libbox.newService(content, platformInterface)
} catch (e: Exception) {
stopAndAlert(Alert.CreateService, e.message)
return
}
if (delayStart) {
delay(1000L)
}
newService.start()
boxService = newService
commandServer?.setService(boxService)
status.postValue(Status.Started)
withContext(Dispatchers.Main) {
notification.show(activeProfileName, R.string.status_started)
}
notification.start()
} catch (e: Exception) {
stopAndAlert(Alert.StartService, e.message)
return
}
}
override fun serviceReload() {
notification.close()
status.postValue(Status.Starting)
val pfd = fileDescriptor
if (pfd != null) {
pfd.close()
fileDescriptor = null
}
commandServer?.setService(null)
boxService?.apply {
runCatching {
close()
}.onFailure {
writeLog("service: error when closing: $it")
}
Seq.destroyRef(refnum)
}
boxService = null
runBlocking {
startService(true)
}
}
override fun getSystemProxyStatus(): SystemProxyStatus {
val status = SystemProxyStatus()
if (service is VPNService) {
status.available = service.systemProxyAvailable
status.enabled = service.systemProxyEnabled
}
return status
}
override fun setSystemProxyEnabled(isEnabled: Boolean) {
serviceReload()
}
@RequiresApi(Build.VERSION_CODES.M)
private fun serviceUpdateIdleMode() {
if (Application.powerManager.isDeviceIdleMode) {
boxService?.pause()
} else {
boxService?.wake()
}
}
private fun stopService() {
if (status.value != Status.Started) return
status.value = Status.Stopping
if (receiverRegistered) {
service.unregisterReceiver(receiver)
receiverRegistered = false
}
notification.close()
GlobalScope.launch(Dispatchers.IO) {
val pfd = fileDescriptor
if (pfd != null) {
pfd.close()
fileDescriptor = null
}
commandServer?.setService(null)
boxService?.apply {
runCatching {
close()
}.onFailure {
writeLog("service: error when closing: $it")
}
Seq.destroyRef(refnum)
}
boxService = null
Libbox.registerLocalDNSTransport(null)
DefaultNetworkMonitor.stop()
commandServer?.apply {
close()
Seq.destroyRef(refnum)
}
commandServer = null
Settings.startedByUser = false
withContext(Dispatchers.Main) {
status.value = Status.Stopped
service.stopSelf()
}
}
}
override fun postServiceClose() {
// Not used on Android
}
private suspend fun stopAndAlert(type: Alert, message: String? = null) {
Settings.startedByUser = false
withContext(Dispatchers.Main) {
if (receiverRegistered) {
service.unregisterReceiver(receiver)
receiverRegistered = false
}
notification.close()
binder.broadcast { callback ->
callback.onServiceAlert(type.ordinal, message)
}
status.value = Status.Stopped
}
}
fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
if (status.value != Status.Stopped) return Service.START_NOT_STICKY
status.value = Status.Starting
if (!receiverRegistered) {
ContextCompat.registerReceiver(service, receiver, IntentFilter().apply {
addAction(Action.SERVICE_CLOSE)
addAction(Action.SERVICE_RELOAD)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
addAction(PowerManager.ACTION_DEVICE_IDLE_MODE_CHANGED)
}
}, ContextCompat.RECEIVER_NOT_EXPORTED)
receiverRegistered = true
}
GlobalScope.launch(Dispatchers.IO) {
Settings.startedByUser = true
initialize()
try {
startCommandServer()
} catch (e: Exception) {
stopAndAlert(Alert.StartCommandServer, e.message)
return@launch
}
startService()
}
return Service.START_NOT_STICKY
}
fun onBind(intent: Intent): IBinder {
return binder
}
fun onDestroy() {
binder.close()
}
fun onRevoke() {
stopService()
}
fun writeLog(message: String) {
binder.broadcast {
it.onServiceWriteLog(message)
}
}
}

180
android/app/src/main/kotlin/com/hiddify/hiddify/bg/DefaultNetworkListener.kt Executable file
View File

@ -0,0 +1,180 @@
package com.hiddify.hiddify.bg
import android.annotation.TargetApi
import android.net.ConnectivityManager
import android.net.Network
import android.net.NetworkCapabilities
import android.net.NetworkRequest
import android.os.Build
import android.os.Handler
import android.os.Looper
import com.hiddify.hiddify.Application
import kotlinx.coroutines.CompletableDeferred
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.channels.actor
import kotlinx.coroutines.runBlocking
import java.net.UnknownHostException
object DefaultNetworkListener {
private sealed class NetworkMessage {
class Start(val key: Any, val listener: (Network?) -> Unit) : NetworkMessage()
class Get : NetworkMessage() {
val response = CompletableDeferred<Network>()
}
class Stop(val key: Any) : NetworkMessage()
class Put(val network: Network) : NetworkMessage()
class Update(val network: Network) : NetworkMessage()
class Lost(val network: Network) : NetworkMessage()
}
private val networkActor = GlobalScope.actor<NetworkMessage>(Dispatchers.Unconfined) {
val listeners = mutableMapOf<Any, (Network?) -> Unit>()
var network: Network? = null
val pendingRequests = arrayListOf<NetworkMessage.Get>()
for (message in channel) when (message) {
is NetworkMessage.Start -> {
if (listeners.isEmpty()) register()
listeners[message.key] = message.listener
if (network != null) message.listener(network)
}
is NetworkMessage.Get -> {
check(listeners.isNotEmpty()) { "Getting network without any listeners is not supported" }
if (network == null) pendingRequests += message else message.response.complete(
network
)
}
is NetworkMessage.Stop -> if (listeners.isNotEmpty() && // was not empty
listeners.remove(message.key) != null && listeners.isEmpty()
) {
network = null
unregister()
}
is NetworkMessage.Put -> {
network = message.network
pendingRequests.forEach { it.response.complete(message.network) }
pendingRequests.clear()
listeners.values.forEach { it(network) }
}
is NetworkMessage.Update -> if (network == message.network) listeners.values.forEach {
it(
network
)
}
is NetworkMessage.Lost -> if (network == message.network) {
network = null
listeners.values.forEach { it(null) }
}
}
}
suspend fun start(key: Any, listener: (Network?) -> Unit) = networkActor.send(
NetworkMessage.Start(
key,
listener
)
)
suspend fun get() = if (fallback) @TargetApi(23) {
Application.connectivity.activeNetwork
?: throw UnknownHostException() // failed to listen, return current if available
} else NetworkMessage.Get().run {
networkActor.send(this)
response.await()
}
suspend fun stop(key: Any) = networkActor.send(NetworkMessage.Stop(key))
// NB: this runs in ConnectivityThread, and this behavior cannot be changed until API 26
private object Callback : ConnectivityManager.NetworkCallback() {
override fun onAvailable(network: Network) = runBlocking {
networkActor.send(
NetworkMessage.Put(
network
)
)
}
override fun onCapabilitiesChanged(
network: Network,
networkCapabilities: NetworkCapabilities
) {
// it's a good idea to refresh capabilities
runBlocking { networkActor.send(NetworkMessage.Update(network)) }
}
override fun onLost(network: Network) = runBlocking {
networkActor.send(
NetworkMessage.Lost(
network
)
)
}
}
private var fallback = false
private val request = NetworkRequest.Builder().apply {
addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
addCapability(NetworkCapabilities.NET_CAPABILITY_NOT_RESTRICTED)
if (Build.VERSION.SDK_INT == 23) { // workarounds for OEM bugs
removeCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED)
removeCapability(NetworkCapabilities.NET_CAPABILITY_CAPTIVE_PORTAL)
}
}.build()
private val mainHandler = Handler(Looper.getMainLooper())
/**
* Unfortunately registerDefaultNetworkCallback is going to return VPN interface since Android P DP1:
* https://android.googlesource.com/platform/frameworks/base/+/dda156ab0c5d66ad82bdcf76cda07cbc0a9c8a2e
*
* This makes doing a requestNetwork with REQUEST necessary so that we don't get ALL possible networks that
* satisfies default network capabilities but only THE default network. Unfortunately, we need to have
* android.permission.CHANGE_NETWORK_STATE to be able to call requestNetwork.
*
* Source: https://android.googlesource.com/platform/frameworks/base/+/2df4c7d/services/core/java/com/android/server/ConnectivityService.java#887
*/
private fun register() {
when (Build.VERSION.SDK_INT) {
in 31..Int.MAX_VALUE -> @TargetApi(31) {
Application.connectivity.registerBestMatchingNetworkCallback(
request,
Callback,
mainHandler
)
}
in 28 until 31 -> @TargetApi(28) { // we want REQUEST here instead of LISTEN
Application.connectivity.requestNetwork(request, Callback, mainHandler)
}
in 26 until 28 -> @TargetApi(26) {
Application.connectivity.registerDefaultNetworkCallback(Callback, mainHandler)
}
in 24 until 26 -> @TargetApi(24) {
Application.connectivity.registerDefaultNetworkCallback(Callback)
}
else -> try {
fallback = false
Application.connectivity.requestNetwork(request, Callback)
} catch (e: RuntimeException) {
fallback =
true // known bug on API 23: https://stackoverflow.com/a/33509180/2245107
}
}
}
private fun unregister() {
runCatching {
Application.connectivity.unregisterNetworkCallback(Callback)
}
}
}

67
android/app/src/main/kotlin/com/hiddify/hiddify/bg/DefaultNetworkMonitor.kt Executable file
View File

@ -0,0 +1,67 @@
package com.hiddify.hiddify.bg
import android.net.Network
import android.os.Build
import com.hiddify.hiddify.Application
import io.nekohasekai.libbox.InterfaceUpdateListener
import java.net.NetworkInterface
object DefaultNetworkMonitor {
var defaultNetwork: Network? = null
private var listener: InterfaceUpdateListener? = null
suspend fun start() {
DefaultNetworkListener.start(this) {
defaultNetwork = it
checkDefaultInterfaceUpdate(it)
}
defaultNetwork = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
Application.connectivity.activeNetwork
} else {
DefaultNetworkListener.get()
}
}
suspend fun stop() {
DefaultNetworkListener.stop(this)
}
suspend fun require(): Network {
val network = defaultNetwork
if (network != null) {
return network
}
return DefaultNetworkListener.get()
}
fun setListener(listener: InterfaceUpdateListener?) {
this.listener = listener
checkDefaultInterfaceUpdate(defaultNetwork)
}
private fun checkDefaultInterfaceUpdate(
newNetwork: Network?
) {
val listener = listener ?: return
if (newNetwork != null) {
val interfaceName =
(Application.connectivity.getLinkProperties(newNetwork) ?: return).interfaceName
for (times in 0 until 10) {
var interfaceIndex: Int
try {
interfaceIndex = NetworkInterface.getByName(interfaceName).index
} catch (e: Exception) {
Thread.sleep(100)
continue
}
listener.updateDefaultInterface(interfaceName, interfaceIndex)
}
} else {
listener.updateDefaultInterface("", -1)
}
}
}

134
android/app/src/main/kotlin/com/hiddify/hiddify/bg/LocalResolver.kt Executable file
View File

@ -0,0 +1,134 @@
package com.hiddify.hiddify.bg
import android.net.DnsResolver
import android.os.Build
import android.os.CancellationSignal
import android.system.ErrnoException
import androidx.annotation.RequiresApi
import com.hiddify.hiddify.ktx.tryResumeWithException
import io.nekohasekai.libbox.ExchangeContext
import io.nekohasekai.libbox.LocalDNSTransport
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.asExecutor
import kotlinx.coroutines.runBlocking
import java.net.InetAddress
import java.net.UnknownHostException
import kotlin.coroutines.resume
import kotlin.coroutines.suspendCoroutine
object LocalResolver : LocalDNSTransport {
private const val RCODE_NXDOMAIN = 3
override fun raw(): Boolean {
return Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q
}
@RequiresApi(Build.VERSION_CODES.Q)
override fun exchange(ctx: ExchangeContext, message: ByteArray) {
return runBlocking {
val defaultNetwork = DefaultNetworkMonitor.require()
suspendCoroutine { continuation ->
val signal = CancellationSignal()
ctx.onCancel(signal::cancel)
val callback = object : DnsResolver.Callback<ByteArray> {
override fun onAnswer(answer: ByteArray, rcode: Int) {
if (rcode == 0) {
ctx.rawSuccess(answer)
} else {
ctx.errorCode(rcode)
}
continuation.resume(Unit)
}
override fun onError(error: DnsResolver.DnsException) {
when (val cause = error.cause) {
is ErrnoException -> {
ctx.errnoCode(cause.errno)
continuation.resume(Unit)
return
}
}
continuation.tryResumeWithException(error)
}
}
DnsResolver.getInstance().rawQuery(
defaultNetwork,
message,
DnsResolver.FLAG_NO_RETRY,
Dispatchers.IO.asExecutor(),
signal,
callback
)
}
}
}
override fun lookup(ctx: ExchangeContext, network: String, domain: String) {
return runBlocking {
val defaultNetwork = DefaultNetworkMonitor.require()
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
suspendCoroutine { continuation ->
val signal = CancellationSignal()
ctx.onCancel(signal::cancel)
val callback = object : DnsResolver.Callback<Collection<InetAddress>> {
@Suppress("ThrowableNotThrown")
override fun onAnswer(answer: Collection<InetAddress>, rcode: Int) {
if (rcode == 0) {
ctx.success((answer as Collection<InetAddress?>).mapNotNull { it?.hostAddress }
.joinToString("\n"))
} else {
ctx.errorCode(rcode)
}
continuation.resume(Unit)
}
override fun onError(error: DnsResolver.DnsException) {
when (val cause = error.cause) {
is ErrnoException -> {
ctx.errnoCode(cause.errno)
continuation.resume(Unit)
return
}
}
continuation.tryResumeWithException(error)
}
}
val type = when {
network.endsWith("4") -> DnsResolver.TYPE_A
network.endsWith("6") -> DnsResolver.TYPE_AAAA
else -> null
}
if (type != null) {
DnsResolver.getInstance().query(
defaultNetwork,
domain,
type,
DnsResolver.FLAG_NO_RETRY,
Dispatchers.IO.asExecutor(),
signal,
callback
)
} else {
DnsResolver.getInstance().query(
defaultNetwork,
domain,
DnsResolver.FLAG_NO_RETRY,
Dispatchers.IO.asExecutor(),
signal,
callback
)
}
}
} else {
val answer = try {
defaultNetwork.getAllByName(domain)
} catch (e: UnknownHostException) {
ctx.errorCode(RCODE_NXDOMAIN)
return@runBlocking
}
ctx.success(answer.mapNotNull { it.hostAddress }.joinToString("\n"))
}
}
}
}

156
android/app/src/main/kotlin/com/hiddify/hiddify/bg/PlatformInterfaceWrapper.kt Executable file
View File

@ -0,0 +1,156 @@
package com.hiddify.hiddify.bg
import android.content.pm.PackageManager
import android.os.Build
import android.os.Process
import androidx.annotation.RequiresApi
import com.hiddify.hiddify.Application
import io.nekohasekai.libbox.InterfaceUpdateListener
import io.nekohasekai.libbox.NetworkInterfaceIterator
import io.nekohasekai.libbox.PlatformInterface
import io.nekohasekai.libbox.StringIterator
import io.nekohasekai.libbox.TunOptions
import io.nekohasekai.libbox.WIFIState
import java.net.Inet6Address
import java.net.InetSocketAddress
import java.net.InterfaceAddress
import java.net.NetworkInterface
import java.util.Enumeration
import io.nekohasekai.libbox.NetworkInterface as LibboxNetworkInterface
interface PlatformInterfaceWrapper : PlatformInterface {
override fun usePlatformAutoDetectInterfaceControl(): Boolean {
return true
}
override fun autoDetectInterfaceControl(fd: Int) {
}
override fun openTun(options: TunOptions): Int {
error("invalid argument")
}
override fun useProcFS(): Boolean {
return Build.VERSION.SDK_INT < Build.VERSION_CODES.Q
}
@RequiresApi(Build.VERSION_CODES.Q)
override fun findConnectionOwner(
ipProtocol: Int,
sourceAddress: String,
sourcePort: Int,
destinationAddress: String,
destinationPort: Int
): Int {
val uid = Application.connectivity.getConnectionOwnerUid(
ipProtocol,
InetSocketAddress(sourceAddress, sourcePort),
InetSocketAddress(destinationAddress, destinationPort)
)
if (uid == Process.INVALID_UID) error("android: connection owner not found")
return uid
}
override fun packageNameByUid(uid: Int): String {
val packages = Application.packageManager.getPackagesForUid(uid)
if (packages.isNullOrEmpty()) error("android: package not found")
return packages[0]
}
@Suppress("DEPRECATION")
override fun uidByPackageName(packageName: String): Int {
return try {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
Application.packageManager.getPackageUid(
packageName, PackageManager.PackageInfoFlags.of(0)
)
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
Application.packageManager.getPackageUid(packageName, 0)
} else {
Application.packageManager.getApplicationInfo(packageName, 0).uid
}
} catch (e: PackageManager.NameNotFoundException) {
error("android: package not found")
}
}
override fun usePlatformDefaultInterfaceMonitor(): Boolean {
return true
}
override fun startDefaultInterfaceMonitor(listener: InterfaceUpdateListener) {
DefaultNetworkMonitor.setListener(listener)
}
override fun closeDefaultInterfaceMonitor(listener: InterfaceUpdateListener) {
DefaultNetworkMonitor.setListener(null)
}
override fun usePlatformInterfaceGetter(): Boolean {
return Build.VERSION.SDK_INT >= Build.VERSION_CODES.R
}
override fun getInterfaces(): NetworkInterfaceIterator {
return InterfaceArray(NetworkInterface.getNetworkInterfaces())
}
override fun underNetworkExtension(): Boolean {
return false
}
override fun includeAllNetworks(): Boolean {
return false
}
override fun clearDNSCache() {
}
override fun readWIFIState(): WIFIState? {
return null
}
private class InterfaceArray(private val iterator: Enumeration<NetworkInterface>) :
NetworkInterfaceIterator {
override fun hasNext(): Boolean {
return iterator.hasMoreElements()
}
override fun next(): LibboxNetworkInterface {
val element = iterator.nextElement()
return LibboxNetworkInterface().apply {
name = element.name
index = element.index
runCatching {
mtu = element.mtu
}
addresses =
StringArray(
element.interfaceAddresses.mapTo(mutableListOf()) { it.toPrefix() }
.iterator()
)
}
}
private fun InterfaceAddress.toPrefix(): String {
return if (address is Inet6Address) {
"${Inet6Address.getByAddress(address.address).hostAddress}/${networkPrefixLength}"
} else {
"${address.hostAddress}/${networkPrefixLength}"
}
}
}
private class StringArray(private val iterator: Iterator<String>) : StringIterator {
override fun hasNext(): Boolean {
return iterator.hasNext()
}
override fun next(): String {
return iterator.next()
}
}
}

17
android/app/src/main/kotlin/com/hiddify/hiddify/bg/ProxyService.kt Executable file
View File

@ -0,0 +1,17 @@
package com.hiddify.hiddify.bg
import android.app.Service
import android.content.Intent
class ProxyService : Service(), PlatformInterfaceWrapper {
private val service = BoxService(this, this)
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int) =
service.onStartCommand(intent, flags, startId)
override fun onBind(intent: Intent) = service.onBind(intent)
override fun onDestroy() = service.onDestroy()
override fun writeLog(message: String) = service.writeLog(message)
}

59
android/app/src/main/kotlin/com/hiddify/hiddify/bg/ServiceBinder.kt Executable file
View File

@ -0,0 +1,59 @@
package com.hiddify.hiddify.bg
import android.os.RemoteCallbackList
import androidx.lifecycle.MutableLiveData
import com.hiddify.hiddify.IService
import com.hiddify.hiddify.IServiceCallback
import com.hiddify.hiddify.constant.Status
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch
import kotlinx.coroutines.sync.Mutex
import kotlinx.coroutines.sync.withLock
class ServiceBinder(private val status: MutableLiveData<Status>) : IService.Stub() {
private val callbacks = RemoteCallbackList<IServiceCallback>()
private val broadcastLock = Mutex()
init {
status.observeForever {
broadcast { callback ->
callback.onServiceStatusChanged(it.ordinal)
}
}
}
fun broadcast(work: (IServiceCallback) -> Unit) {
GlobalScope.launch(Dispatchers.Main) {
broadcastLock.withLock {
val count = callbacks.beginBroadcast()
try {
repeat(count) {
try {
work(callbacks.getBroadcastItem(it))
} catch (_: Exception) {
}
}
} finally {
callbacks.finishBroadcast()
}
}
}
}
override fun getStatus(): Int {
return (status.value ?: Status.Stopped).ordinal
}
override fun registerCallback(callback: IServiceCallback) {
callbacks.register(callback)
}
override fun unregisterCallback(callback: IServiceCallback?) {
callbacks.unregister(callback)
}
fun close() {
callbacks.kill()
}
}

109
android/app/src/main/kotlin/com/hiddify/hiddify/bg/ServiceConnection.kt Executable file
View File

@ -0,0 +1,109 @@
package com.hiddify.hiddify.bg
import com.hiddify.hiddify.IService
import com.hiddify.hiddify.IServiceCallback
import com.hiddify.hiddify.Settings
import com.hiddify.hiddify.constant.Action
import com.hiddify.hiddify.constant.Alert
import com.hiddify.hiddify.constant.Status
import android.content.ComponentName
import android.content.Context
import android.content.Intent
import android.content.ServiceConnection
import android.os.IBinder
import android.os.RemoteException
import android.util.Log
import androidx.appcompat.app.AppCompatActivity
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.runBlocking
import kotlinx.coroutines.withContext
class ServiceConnection(
private val context: Context,
callback: Callback,
private val register: Boolean = true,
) : ServiceConnection {
companion object {
private const val TAG = "ServiceConnection"
}
private val callback = ServiceCallback(callback)
private var service: IService? = null
val status get() = service?.status?.let { Status.values()[it] } ?: Status.Stopped
fun connect() {
val intent = runBlocking {
withContext(Dispatchers.IO) {
Intent(context, Settings.serviceClass()).setAction(Action.SERVICE)
}
}
context.bindService(intent, this, AppCompatActivity.BIND_AUTO_CREATE)
}
fun disconnect() {
try {
context.unbindService(this)
} catch (_: IllegalArgumentException) {
}
}
fun reconnect() {
try {
context.unbindService(this)
} catch (_: IllegalArgumentException) {
}
val intent = runBlocking {
withContext(Dispatchers.IO) {
Intent(context, Settings.serviceClass()).setAction(Action.SERVICE)
}
}
context.bindService(intent, this, AppCompatActivity.BIND_AUTO_CREATE)
}
override fun onServiceConnected(name: ComponentName, binder: IBinder) {
val service = IService.Stub.asInterface(binder)
this.service = service
try {
if (register) service.registerCallback(callback)
callback.onServiceStatusChanged(service.status)
} catch (e: RemoteException) {
Log.e(TAG, "initialize service connection", e)
}
}
override fun onServiceDisconnected(name: ComponentName?) {
try {
service?.unregisterCallback(callback)
} catch (e: RemoteException) {
Log.e(TAG, "cleanup service connection", e)
}
}
override fun onBindingDied(name: ComponentName?) {
reconnect()
}
interface Callback {
fun onServiceStatusChanged(status: Status)
fun onServiceAlert(type: Alert, message: String?) {}
fun onServiceWriteLog(message: String?) {}
fun onServiceResetLogs(messages: MutableList<String>) {}
}
class ServiceCallback(private val callback: Callback) : IServiceCallback.Stub() {
override fun onServiceStatusChanged(status: Int) {
callback.onServiceStatusChanged(Status.values()[status])
}
override fun onServiceAlert(type: Int, message: String?) {
callback.onServiceAlert(Alert.values()[type], message)
}
override fun onServiceWriteLog(message: String?) = callback.onServiceWriteLog(message)
override fun onServiceResetLogs(messages: MutableList<String>) =
callback.onServiceResetLogs(messages)
}
}

143
android/app/src/main/kotlin/com/hiddify/hiddify/bg/ServiceNotification.kt Executable file
View File

@ -0,0 +1,143 @@
package com.hiddify.hiddify.bg
import android.app.NotificationChannel
import android.app.NotificationManager
import android.app.PendingIntent
import android.app.Service
import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import android.content.IntentFilter
import android.os.Build
import androidx.annotation.StringRes
import androidx.core.app.NotificationCompat
import androidx.core.app.ServiceCompat
import androidx.lifecycle.MutableLiveData
import com.hiddify.hiddify.Application
import com.hiddify.hiddify.MainActivity
import com.hiddify.hiddify.R
import com.hiddify.hiddify.Settings
import com.hiddify.hiddify.constant.Action
import com.hiddify.hiddify.constant.Status
import com.hiddify.hiddify.utils.CommandClient
import io.nekohasekai.libbox.Libbox
import io.nekohasekai.libbox.StatusMessage
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.withContext
class ServiceNotification(private val status: MutableLiveData<Status>, private val service: Service) : BroadcastReceiver(), CommandClient.Handler {
companion object {
private const val notificationId = 1
private const val notificationChannel = "service"
private val flags =
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) PendingIntent.FLAG_IMMUTABLE else 0
fun checkPermission(): Boolean {
// 暂时禁用通知权限检查
return true
}
}
private val commandClient =
CommandClient(GlobalScope, CommandClient.ConnectionType.Status, this)
private var receiverRegistered = false
private val notificationBuilder by lazy {
NotificationCompat.Builder(service, notificationChannel)
.setShowWhen(false)
.setOngoing(true)
.setContentTitle("BearVPN")
.setOnlyAlertOnce(true)
.setSmallIcon(R.drawable.ic_stat_logo)
.setCategory(NotificationCompat.CATEGORY_SERVICE)
.setContentIntent(
PendingIntent.getActivity(
service,
0,
Intent(
service,
MainActivity::class.java
).setFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT),
flags
)
)
.setPriority(NotificationCompat.PRIORITY_LOW).apply {
addAction(
NotificationCompat.Action.Builder(
0, service.getText(R.string.stop), PendingIntent.getBroadcast(
service,
0,
Intent(Action.SERVICE_CLOSE).setPackage(service.packageName),
flags
)
).build()
)
}
}
fun show(profileName: String, @StringRes contentTextId: Int) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
Application.notification.createNotificationChannel(
NotificationChannel(
notificationChannel, "hiddify service", NotificationManager.IMPORTANCE_LOW
)
)
}
service.startForeground(
notificationId, notificationBuilder
.setContentTitle(profileName.takeIf { it.isNotBlank() } ?: "Hiddify")
.setContentText(service.getString(contentTextId)).build()
)
}
suspend fun start() {
if (Settings.dynamicNotification) {
commandClient.connect()
withContext(Dispatchers.Main) {
registerReceiver()
}
}
}
private fun registerReceiver() {
service.registerReceiver(this, IntentFilter().apply {
addAction(Intent.ACTION_SCREEN_ON)
addAction(Intent.ACTION_SCREEN_OFF)
})
receiverRegistered = true
}
override fun updateStatus(status: StatusMessage) {
val content =
Libbox.formatBytes(status.uplink) + "/s ↑\t" + Libbox.formatBytes(status.downlink) + "/s ↓"
Application.notificationManager.notify(
notificationId,
notificationBuilder.setContentText(content).build()
)
}
override fun onReceive(context: Context, intent: Intent) {
when (intent.action) {
Intent.ACTION_SCREEN_ON -> {
commandClient.connect()
}
Intent.ACTION_SCREEN_OFF -> {
commandClient.disconnect()
}
}
}
fun close() {
commandClient.disconnect()
ServiceCompat.stopForeground(service, ServiceCompat.STOP_FOREGROUND_REMOVE)
if (receiverRegistered) {
service.unregisterReceiver(this)
receiverRegistered = false
}
}
}

48
android/app/src/main/kotlin/com/hiddify/hiddify/bg/TileService.kt Executable file
View File

@ -0,0 +1,48 @@
package com.hiddify.hiddify.bg
import android.service.quicksettings.Tile
import android.service.quicksettings.TileService
import androidx.annotation.RequiresApi
import com.hiddify.hiddify.constant.Status
@RequiresApi(24)
class TileService : TileService(), ServiceConnection.Callback {
private val connection = ServiceConnection(this, this)
override fun onServiceStatusChanged(status: Status) {
qsTile?.apply {
state = when (status) {
Status.Started -> Tile.STATE_ACTIVE
Status.Stopped -> Tile.STATE_INACTIVE
else -> Tile.STATE_UNAVAILABLE
}
updateTile()
}
}
override fun onStartListening() {
super.onStartListening()
connection.connect()
}
override fun onStopListening() {
connection.disconnect()
super.onStopListening()
}
override fun onClick() {
when (connection.status) {
Status.Stopped -> {
BoxService.start()
}
Status.Started -> {
BoxService.stop()
}
else -> {}
}
}
}

199
android/app/src/main/kotlin/com/hiddify/hiddify/bg/VPNService.kt Executable file
View File

@ -0,0 +1,199 @@
package com.hiddify.hiddify.bg
import android.util.Log
import com.hiddify.hiddify.Settings
import android.content.Intent
import android.content.pm.PackageManager.NameNotFoundException
import android.net.ProxyInfo
import android.net.VpnService
import android.os.Build
import android.os.IBinder
import com.hiddify.hiddify.constant.PerAppProxyMode
import com.hiddify.hiddify.ktx.toIpPrefix
import io.nekohasekai.libbox.TunOptions
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.runBlocking
import kotlinx.coroutines.withContext
class VPNService : VpnService(), PlatformInterfaceWrapper {
companion object {
private const val TAG = "A/VPNService"
}
private val service = BoxService(this, this)
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int) =
service.onStartCommand(intent, flags, startId)
override fun onBind(intent: Intent): IBinder {
val binder = super.onBind(intent)
if (binder != null) {
return binder
}
return service.onBind(intent)
}
override fun onDestroy() {
service.onDestroy()
}
override fun onRevoke() {
runBlocking {
withContext(Dispatchers.Main) {
service.onRevoke()
}
}
}
override fun autoDetectInterfaceControl(fd: Int) {
protect(fd)
}
var systemProxyAvailable = false
var systemProxyEnabled = false
fun addIncludePackage(builder: Builder, packageName: String) {
if (packageName == this.packageName) {
Log.d("VpnService","Cannot include myself: $packageName")
return
}
try {
Log.d("VpnService","Including $packageName")
builder.addAllowedApplication(packageName)
} catch (e: NameNotFoundException) {
}
}
fun addExcludePackage(builder: Builder, packageName: String) {
try {
Log.d("VpnService","Excluding $packageName")
builder.addDisallowedApplication(packageName)
} catch (e: NameNotFoundException) {
}
}
override fun openTun(options: TunOptions): Int {
if (prepare(this) != null) error("android: missing vpn permission")
val builder = Builder()
.setSession("sing-box")
.setMtu(options.mtu)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
builder.setMetered(false)
}
val inet4Address = options.inet4Address
while (inet4Address.hasNext()) {
val address = inet4Address.next()
builder.addAddress(address.address(), address.prefix())
}
val inet6Address = options.inet6Address
while (inet6Address.hasNext()) {
val address = inet6Address.next()
builder.addAddress(address.address(), address.prefix())
}
if (options.autoRoute) {
builder.addDnsServer(options.dnsServerAddress)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
val inet4RouteAddress = options.inet4RouteAddress
if (inet4RouteAddress.hasNext()) {
while (inet4RouteAddress.hasNext()) {
builder.addRoute(inet4RouteAddress.next().toIpPrefix())
}
} else {
builder.addRoute("0.0.0.0", 0)
}
val inet6RouteAddress = options.inet6RouteAddress
if (inet6RouteAddress.hasNext()) {
while (inet6RouteAddress.hasNext()) {
builder.addRoute(inet6RouteAddress.next().toIpPrefix())
}
} else {
builder.addRoute("::", 0)
}
val inet4RouteExcludeAddress = options.inet4RouteExcludeAddress
while (inet4RouteExcludeAddress.hasNext()) {
builder.excludeRoute(inet4RouteExcludeAddress.next().toIpPrefix())
}
val inet6RouteExcludeAddress = options.inet6RouteExcludeAddress
while (inet6RouteExcludeAddress.hasNext()) {
builder.excludeRoute(inet6RouteExcludeAddress.next().toIpPrefix())
}
} else {
val inet4RouteAddress = options.inet4RouteRange
if (inet4RouteAddress.hasNext()) {
while (inet4RouteAddress.hasNext()) {
val address = inet4RouteAddress.next()
builder.addRoute(address.address(), address.prefix())
}
}
val inet6RouteAddress = options.inet6RouteRange
if (inet6RouteAddress.hasNext()) {
while (inet6RouteAddress.hasNext()) {
val address = inet6RouteAddress.next()
builder.addRoute(address.address(), address.prefix())
}
}
}
if (Settings.perAppProxyEnabled) {
val appList = Settings.perAppProxyList
if (Settings.perAppProxyMode == PerAppProxyMode.INCLUDE) {
appList.forEach {
addIncludePackage(builder,it)
}
addIncludePackage(builder,packageName)
} else {
appList.forEach {
addExcludePackage(builder,it)
}
//addExcludePackage(builder,packageName)
}
} else {
val includePackage = options.includePackage
if (includePackage.hasNext()) {
while (includePackage.hasNext()) {
addIncludePackage(builder,includePackage.next())
}
}
val excludePackage = options.excludePackage
if (excludePackage.hasNext()) {
while (excludePackage.hasNext()) {
addExcludePackage(builder,excludePackage.next())
}
}
//addExcludePackage(builder,packageName)
}
}
if (options.isHTTPProxyEnabled && Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
systemProxyAvailable = true
systemProxyEnabled = Settings.systemProxyEnabled
if (systemProxyEnabled) builder.setHttpProxy(
ProxyInfo.buildDirectProxy(
options.httpProxyServer, options.httpProxyServerPort
)
)
} else {
systemProxyAvailable = false
systemProxyEnabled = false
}
val pfd =
builder.establish() ?: error("android: the application is not prepared or is revoked")
service.fileDescriptor = pfd
return pfd.fd
}
override fun writeLog(message: String) = service.writeLog(message)
}

7
android/app/src/main/kotlin/com/hiddify/hiddify/constant/Action.kt Executable file
View File

@ -0,0 +1,7 @@
package com.hiddify.hiddify.constant
object Action {
const val SERVICE = "com.baer.app.SERVICE"
const val SERVICE_CLOSE = "com.baer.app.SERVICE_CLOSE"
const val SERVICE_RELOAD = "com.baer.app.sfa.SERVICE_RELOAD"
}

10
android/app/src/main/kotlin/com/hiddify/hiddify/constant/Alert.kt Executable file
View File

@ -0,0 +1,10 @@
package com.hiddify.hiddify.constant
enum class Alert {
RequestVPNPermission,
RequestNotificationPermission,
EmptyConfiguration,
StartCommandServer,
CreateService,
StartService
}

7
android/app/src/main/kotlin/com/hiddify/hiddify/constant/PerAppProxyMode.kt Executable file
View File

@ -0,0 +1,7 @@
package com.hiddify.hiddify.constant
object PerAppProxyMode {
const val OFF = "off"
const val INCLUDE = "include"
const val EXCLUDE = "exclude"
}

6
android/app/src/main/kotlin/com/hiddify/hiddify/constant/ServiceMode.kt Executable file
View File

@ -0,0 +1,6 @@
package com.hiddify.hiddify.constant
object ServiceMode {
const val NORMAL = "proxy"
const val VPN = "vpn"
}

24
android/app/src/main/kotlin/com/hiddify/hiddify/constant/SettingsKey.kt Executable file
View File

@ -0,0 +1,24 @@
package com.hiddify.hiddify.constant
object SettingsKey {
private const val KEY_PREFIX = "flutter."
const val SERVICE_MODE = "${KEY_PREFIX}service-mode"
const val ACTIVE_CONFIG_PATH = "${KEY_PREFIX}active_config_path"
const val ACTIVE_PROFILE_NAME = "${KEY_PREFIX}active_profile_name"
const val PER_APP_PROXY_MODE = "${KEY_PREFIX}per_app_proxy_mode"
const val PER_APP_PROXY_INCLUDE_LIST = "${KEY_PREFIX}per_app_proxy_include_list"
const val PER_APP_PROXY_EXCLUDE_LIST = "${KEY_PREFIX}per_app_proxy_exclude_list"
const val DEBUG_MODE = "${KEY_PREFIX}debug_mode"
const val DISABLE_MEMORY_LIMIT = "${KEY_PREFIX}disable_memory_limit"
const val DYNAMIC_NOTIFICATION = "${KEY_PREFIX}dynamic_notification"
const val SYSTEM_PROXY_ENABLED = "${KEY_PREFIX}system_proxy_enabled"
// cache
const val STARTED_BY_USER = "${KEY_PREFIX}started_by_user"
const val CONFIG_OPTIONS = "config_options_json"
}

8
android/app/src/main/kotlin/com/hiddify/hiddify/constant/Status.kt Executable file
View File

@ -0,0 +1,8 @@
package com.hiddify.hiddify.constant
enum class Status {
Stopped,
Starting,
Started,
Stopping,
}

18
android/app/src/main/kotlin/com/hiddify/hiddify/ktx/Continuations.kt Executable file
View File

@ -0,0 +1,18 @@
package com.hiddify.hiddify.ktx
import kotlin.coroutines.Continuation
fun <T> Continuation<T>.tryResume(value: T) {
try {
resumeWith(Result.success(value))
} catch (ignored: IllegalStateException) {
}
}
fun <T> Continuation<T>.tryResumeWithException(exception: Throwable) {
try {
resumeWith(Result.failure(exception))
} catch (ignored: IllegalStateException) {
}
}

19
android/app/src/main/kotlin/com/hiddify/hiddify/ktx/Wrappers.kt Executable file
View File

@ -0,0 +1,19 @@
package com.hiddify.hiddify.ktx
import android.net.IpPrefix
import android.os.Build
import androidx.annotation.RequiresApi
import io.nekohasekai.libbox.RoutePrefix
import io.nekohasekai.libbox.StringIterator
import java.net.InetAddress
fun StringIterator.toList(): List<String> {
return mutableListOf<String>().apply {
while (hasNext()) {
add(next())
}
}
}
@RequiresApi(Build.VERSION_CODES.TIRAMISU)
fun RoutePrefix.toIpPrefix() = IpPrefix(InetAddress.getByName(address()), prefix())

139
android/app/src/main/kotlin/com/hiddify/hiddify/utils/CommandClient.kt Executable file
View File

@ -0,0 +1,139 @@
package com.hiddify.hiddify.utils
import go.Seq
import io.nekohasekai.libbox.CommandClient
import io.nekohasekai.libbox.CommandClientHandler
import io.nekohasekai.libbox.CommandClientOptions
import io.nekohasekai.libbox.Libbox
import io.nekohasekai.libbox.OutboundGroup
import io.nekohasekai.libbox.OutboundGroupIterator
import io.nekohasekai.libbox.StatusMessage
import io.nekohasekai.libbox.StringIterator
import com.hiddify.hiddify.ktx.toList
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.delay
import kotlinx.coroutines.isActive
import kotlinx.coroutines.launch
open class CommandClient(
private val scope: CoroutineScope,
private val connectionType: ConnectionType,
private val handler: Handler
) {
enum class ConnectionType {
Status, Groups, Log, ClashMode, GroupOnly
}
interface Handler {
fun onConnected() {}
fun onDisconnected() {}
fun updateStatus(status: StatusMessage) {}
fun updateGroups(groups: List<OutboundGroup>) {}
fun clearLog() {}
fun appendLog(message: String) {}
fun initializeClashMode(modeList: List<String>, currentMode: String) {}
fun updateClashMode(newMode: String) {}
}
private var commandClient: CommandClient? = null
private val clientHandler = ClientHandler()
fun connect() {
disconnect()
val options = CommandClientOptions()
options.command = when (connectionType) {
ConnectionType.Status -> Libbox.CommandStatus
ConnectionType.Groups -> Libbox.CommandGroup
ConnectionType.Log -> Libbox.CommandLog
ConnectionType.ClashMode -> Libbox.CommandClashMode
ConnectionType.GroupOnly -> Libbox.CommandGroupInfoOnly
}
options.statusInterval = 2 * 1000 * 1000 * 1000
val commandClient = CommandClient(clientHandler, options)
scope.launch(Dispatchers.IO) {
for (i in 1..10) {
delay(100 + i.toLong() * 50)
try {
commandClient.connect()
} catch (ignored: Exception) {
continue
}
if (!isActive) {
runCatching {
commandClient.disconnect()
}
return@launch
}
this@CommandClient.commandClient = commandClient
return@launch
}
runCatching {
commandClient.disconnect()
}
}
}
fun disconnect() {
commandClient?.apply {
runCatching {
disconnect()
}
Seq.destroyRef(refnum)
}
commandClient = null
}
private inner class ClientHandler : CommandClientHandler {
override fun connected() {
handler.onConnected()
}
override fun disconnected(message: String?) {
handler.onDisconnected()
}
override fun writeGroups(message: OutboundGroupIterator?) {
if (message == null) {
return
}
val groups = mutableListOf<OutboundGroup>()
while (message.hasNext()) {
groups.add(message.next())
}
handler.updateGroups(groups)
}
override fun clearLog() {
handler.clearLog()
}
override fun writeLog(message: String?) {
if (message == null) {
return
}
handler.appendLog(message)
}
override fun writeStatus(message: StatusMessage?) {
if (message == null) {
return
}
handler.updateStatus(message)
}
override fun initializeClashMode(modeList: StringIterator, currentMode: String) {
handler.initializeClashMode(modeList.toList(), currentMode)
}
override fun updateClashMode(newMode: String) {
handler.updateClashMode(newMode)
}
}
}

31
android/app/src/main/kotlin/com/hiddify/hiddify/utils/OutboundMapper.kt Executable file
View File

@ -0,0 +1,31 @@
package com.hiddify.hiddify.utils
import com.google.gson.annotations.SerializedName
import io.nekohasekai.libbox.OutboundGroup
import io.nekohasekai.libbox.OutboundGroupItem
data class ParsedOutboundGroup(
@SerializedName("tag") val tag: String,
@SerializedName("type") val type: String,
@SerializedName("selected") val selected: String,
@SerializedName("items") val items: List<ParsedOutboundGroupItem>
) {
companion object {
fun fromOutbound(group: OutboundGroup): ParsedOutboundGroup {
val outboundItems = group.items
val items = mutableListOf<ParsedOutboundGroupItem>()
while (outboundItems.hasNext()) {
items.add(ParsedOutboundGroupItem(outboundItems.next()))
}
return ParsedOutboundGroup(group.tag, group.type, group.selected, items)
}
}
}
data class ParsedOutboundGroupItem(
@SerializedName("tag") val tag: String,
@SerializedName("type") val type: String,
@SerializedName("url-test-delay") val urlTestDelay: Int,
) {
constructor(item: OutboundGroupItem) : this(item.tag, item.type, item.urlTestDelay)
}

BIN
android/app/src/main/res/drawable-hdpi/ic_stat_logo.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-hdpi/splash.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-ldpi/ic_stat_logo.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-ldpi/splash.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-mdpi/ic_stat_logo.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-mdpi/splash.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-v21/background.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 69 B

9
android/app/src/main/res/drawable-v21/launch_background.xml Executable file
View File

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
<item>
<bitmap android:gravity="fill" android:src="@drawable/background"/>
</item>
<item>
<bitmap android:gravity="center" android:src="@drawable/splash"/>
</item>
</layer-list>

BIN
android/app/src/main/res/drawable-xhdpi/ic_stat_logo.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-xhdpi/splash.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-xxhdpi/ic_stat_logo.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-xxhdpi/splash.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-xxxhdpi/ic_stat_logo.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

BIN
android/app/src/main/res/drawable-xxxhdpi/splash.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

13
android/app/src/main/res/drawable/android12splash.xml Executable file
View File

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
<!-- 背景色 -->
<!-- 启动图片 -->
<item>
<bitmap
android:gravity="center"
android:src="@drawable/splash"
android:width="50dp"
android:height="50dp" />
</item>
</layer-list>

BIN
android/app/src/main/res/drawable/background.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 69 B

53
android/app/src/main/res/drawable/ic_banner_foreground.xml Executable file
View File

@ -0,0 +1,53 @@
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="640dp"
android:height="360dp"
android:viewportWidth="640"
android:viewportHeight="360">
<group android:scaleX="0.6666667"
android:scaleY="0.6666667"
android:translateX="110"
android:translateY="65">
<group>
<clip-path
android:pathData="M60,115.28h114.5v113.28h-114.5z"/>
<path
android:pathData="M144.37,140.82C144.37,139.77 144.92,138.8 145.83,138.26L169.93,123.95C171.94,122.76 174.49,124.19 174.49,126.51V151.05C174.49,152.7 173.15,154.03 171.48,154.03H147.38C145.71,154.03 144.37,152.7 144.37,151.05V140.82Z"
android:fillColor="#455FE9"/>
<path
android:pathData="M102.18,164.67C102.18,163.62 102.74,162.65 103.64,162.11L127.75,147.8C129.76,146.61 132.31,148.04 132.31,150.36V192.79V195.77V222.6C132.31,224.25 130.96,225.58 129.3,225.58H105.2C103.53,225.58 102.18,224.25 102.18,222.6V195.77V192.79V164.67ZM61.46,188.94C60.56,189.48 60,190.45 60,191.5V222.6C60,224.25 61.35,225.58 63.01,225.58H87.12C88.78,225.58 90.13,224.25 90.13,222.6V177.19C90.13,174.87 87.58,173.44 85.57,174.63L61.46,188.94Z"
android:fillColor="#455FE9"
android:fillType="evenOdd"/>
<path
android:pathData="M90.13,195.77H72.05V219.62H90.13V213.66C90.13,212.01 91.48,210.68 93.14,210.68H99.17C100.83,210.68 102.18,212.01 102.18,213.66V219.62H126.29V195.77H102.18V201.73C102.18,203.38 100.83,204.71 99.17,204.71H93.14C91.48,204.71 90.13,203.38 90.13,201.73V195.77Z"
android:fillColor="#455FE9"
android:fillType="evenOdd"/>
<path
android:pathData="M144.37,162.98V222.6C144.37,224.25 145.71,225.58 147.38,225.58H171.48C173.15,225.58 174.49,224.25 174.49,222.6V162.98C174.49,161.33 173.15,160 171.48,160H147.38C145.71,160 144.37,161.33 144.37,162.98Z"
android:fillColor="#455FE9"/>
</group>
<path
android:pathData="M536.46,237.06C531.61,237.06 528.04,235.92 525.75,233.66C523.5,231.43 522.38,227.88 522.38,223.01C522.38,221.42 523.18,220.63 524.78,220.63C526.38,220.63 527.18,221.42 527.18,223.01C527.18,226.56 527.85,228.99 529.19,230.32C530.56,231.64 532.98,232.3 536.46,232.3H555.46C558.97,232.3 561.4,231.64 562.73,230.32C564.07,228.99 564.74,226.56 564.74,223.01V207.04C562.64,209.68 559.89,211.59 556.49,212.76C553.14,213.93 549.13,214.51 544.47,214.51H542.07C535.2,214.51 530.2,212.97 527.07,209.87C523.94,206.77 522.38,201.86 522.38,195.14V164.44C522.38,162.86 523.18,162.07 524.78,162.07C526.38,162.07 527.18,162.86 527.18,164.44V195.14C527.18,200.58 528.27,204.38 530.45,206.53C532.66,208.68 536.53,209.76 542.07,209.76H544.47C551.3,209.76 556.38,208.55 559.7,206.13C563.06,203.68 564.74,200.01 564.74,195.14V164.44C564.74,162.86 565.54,162.07 567.14,162.07C568.75,162.07 569.55,162.86 569.55,164.44V223.01C569.55,227.88 568.42,231.43 566.17,233.66C563.92,235.92 560.35,237.06 555.46,237.06H536.46Z"
android:fillColor="#495057"/>
<path
android:pathData="M491.05,214.4C489.45,214.4 488.64,213.61 488.64,212.02V166.94H483.61C482,166.94 481.2,166.15 481.2,164.56C481.2,162.97 482,162.18 483.61,162.18H488.64V155.72C488.64,148.93 490.21,143.98 493.34,140.88C496.47,137.79 501.47,136.24 508.34,136.24C510.02,136.24 510.86,137.03 510.86,138.62C510.86,140.2 510.02,141 508.34,141C502.84,141 498.99,142.09 496.77,144.28C494.56,146.47 493.45,150.29 493.45,155.72V162.18H508.45C510.05,162.18 510.86,162.97 510.86,164.56C510.86,166.15 510.05,166.94 508.45,166.94H493.45V212.02C493.45,213.61 492.65,214.4 491.05,214.4Z"
android:fillColor="#495057"/>
<path
android:pathData="M463.89,151.53C461.6,151.53 460.46,150.36 460.46,148.02V145.7C460.46,143.43 461.6,142.3 463.89,142.3H466.24C468.49,142.3 469.62,143.43 469.62,145.7V148.02C469.62,150.36 468.49,151.53 466.24,151.53H463.89ZM465.1,214.4C463.49,214.4 462.69,213.61 462.69,212.02V164.56C462.69,162.97 463.49,162.18 465.1,162.18C466.7,162.18 467.5,162.97 467.5,164.56V212.02C467.5,213.61 466.7,214.4 465.1,214.4Z"
android:fillColor="#495057"/>
<path
android:pathData="M413.71,214.4C406.73,214.4 401.63,212.84 398.43,209.7C395.26,206.53 393.68,201.49 393.68,194.58V182C393.68,175.09 395.26,170.07 398.43,166.94C401.63,163.77 406.73,162.18 413.71,162.18H438.33V138.62C438.33,137.03 439.13,136.24 440.73,136.24C442.34,136.24 443.14,137.03 443.14,138.62V212.02C443.14,213.61 442.34,214.4 440.73,214.4C439.13,214.4 438.33,213.61 438.33,212.02V205.79C436.73,208.63 434.28,210.78 431,212.25C427.76,213.68 423.45,214.4 418.06,214.4H413.71ZM413.71,209.64H418.06C424.32,209.64 429.27,208.63 432.89,206.59C436.52,204.51 438.33,201.41 438.33,197.3V166.94H413.71C408.1,166.94 404.15,168.07 401.86,170.34C399.61,172.56 398.48,176.45 398.48,182V194.58C398.48,200.13 399.61,204.04 401.86,206.3C404.15,208.53 408.1,209.64 413.71,209.64Z"
android:fillColor="#495057"/>
<path
android:pathData="M345.84,214.4C338.86,214.4 333.76,212.84 330.56,209.7C327.39,206.53 325.81,201.49 325.81,194.58V182C325.81,175.09 327.39,170.07 330.56,166.94C333.76,163.77 338.86,162.18 345.84,162.18H370.46V138.62C370.46,137.03 371.26,136.24 372.86,136.24C374.47,136.24 375.27,137.03 375.27,138.62V212.02C375.27,213.61 374.47,214.4 372.86,214.4C371.26,214.4 370.46,213.61 370.46,212.02V205.79C368.86,208.63 366.41,210.78 363.13,212.25C359.89,213.68 355.58,214.4 350.19,214.4H345.84ZM345.84,209.64H350.19C356.45,209.64 361.39,208.63 365.02,206.59C368.65,204.51 370.46,201.41 370.46,197.3V166.94H345.84C340.23,166.94 336.28,168.07 333.99,170.34C331.74,172.56 330.61,176.45 330.61,182V194.58C330.61,200.13 331.74,204.04 333.99,206.3C336.28,208.53 340.23,209.64 345.84,209.64Z"
android:fillColor="#495057"/>
<path
android:pathData="M302.77,151.53C300.48,151.53 299.34,150.36 299.34,148.02V145.7C299.34,143.43 300.48,142.3 302.77,142.3H305.12C307.37,142.3 308.5,143.43 308.5,145.7V148.02C308.5,150.36 307.37,151.53 305.12,151.53H302.77ZM303.97,214.4C302.37,214.4 301.57,213.61 301.57,212.02V164.56C301.57,162.97 302.37,162.18 303.97,162.18C305.58,162.18 306.38,162.97 306.38,164.56V212.02C306.38,213.61 305.58,214.4 303.97,214.4Z"
android:fillColor="#495057"/>
<path
android:pathData="M225.37,214.4C224.57,214.4 223.96,214.21 223.54,213.84C223.16,213.42 222.97,212.82 222.97,212.02V145.07C222.97,144.28 223.16,143.7 223.54,143.32C223.96,142.9 224.57,142.7 225.37,142.7C226.17,142.7 226.76,142.9 227.15,143.32C227.57,143.7 227.77,144.28 227.77,145.07V175.66H276.21V145.07C276.21,144.28 276.4,143.7 276.78,143.32C277.2,142.9 277.81,142.7 278.61,142.7C279.41,142.7 280,142.9 280.39,143.32C280.8,143.7 281.02,144.28 281.02,145.07V212.02C281.02,212.82 280.8,213.42 280.39,213.84C280,214.21 279.41,214.4 278.61,214.4C277.81,214.4 277.2,214.21 276.78,213.84C276.4,213.42 276.21,212.82 276.21,212.02V180.42H227.77V212.02C227.77,212.82 227.57,213.42 227.15,213.84C226.76,214.21 226.17,214.4 225.37,214.4Z"
android:fillColor="#495057"/>
</group>
</vector>

12
android/app/src/main/res/drawable/ic_launcher_background.xml Executable file
View File

@ -0,0 +1,12 @@
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="2048dp"
android:height="2048dp"
android:viewportWidth="2048"
android:viewportHeight="2048">
<group>
<!-- Filled rectangle -->
<path
android:pathData="M0,0 L2048,0 L2048,2048 L0,2048 Z"
android:fillColor="#FFF0F3FA" />
</group>
</vector>

13
android/app/src/main/res/drawable/launch_background.xml Executable file
View File

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
<item>
<bitmap android:gravity="fill" android:src="@drawable/background"/>
</item>
<item>
<bitmap
android:gravity="center"
android:src="@drawable/splash"
android:width="50dp"
android:height="50dp" />
</item>
</layer-list>

BIN
android/app/src/main/res/drawable/splash.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.0 KiB

5
android/app/src/main/res/mipmap-anydpi-v26/ic_banner.xml Executable file
View File

@ -0,0 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
<background android:drawable="@color/ic_banner_background"/>
<foreground android:drawable="@drawable/ic_banner_foreground"/>
</adaptive-icon>

5
android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml Executable file
View File

@ -0,0 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
<background android:drawable="@color/ic_launcher_background"/>
<foreground android:drawable="@mipmap/ic_launcher_foreground"/>
</adaptive-icon>

5
android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml Executable file
View File

@ -0,0 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
<background android:drawable="@color/ic_launcher_background"/>
<foreground android:drawable="@mipmap/ic_launcher_foreground"/>
</adaptive-icon>

BIN
android/app/src/main/res/mipmap-hdpi/ic_launcher.webp Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.1 KiB

BIN
android/app/src/main/res/mipmap-hdpi/ic_launcher_foreground.webp Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1008 B

BIN
android/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.4 KiB

BIN
android/app/src/main/res/mipmap-mdpi/ic_launcher.webp Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 794 B

BIN
android/app/src/main/res/mipmap-mdpi/ic_launcher_foreground.webp Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 636 B

Some files were not shown because too many files have changed in this diff Show More