YueLink Lite

轻量、直观、跨平台的一键 VPN 客户端。

YueLink Lite 是一个独立的轻量 VPN 客户端，面向日常连接场景设计。应用把主要操作收敛到首页连接、地区选择和我的账户三部分，默认隐藏复杂代理配置、内核参数和高级路由细节。

目标很明确：

• 打开应用即可连接。
• 自动推荐可用地区。
• 只保留 Lite 用户真正需要的账户、套餐、设备、客服、更新和基础设置。
• 五端统一发布，安装包尽量轻。

---

当前能力

模块	能力
首页	一键连接 / 断开、当前地区、连接状态、流量与账户状态
地区	主要国家和地区选择、推荐地区、延迟测试、极速模式 / 安全模式
我的	套餐、流量、到期时间、续费、订单、设备管理、客服、基础设置
设置	主题、语言、自动连接、开机启动、更新通道、隐私、开源许可
更新	GitHub Release 自更新、稳定版 / 预发布通道、SHA-256 校验
平台	Android、iOS、macOS、Windows、Linux

Lite 版主流程不暴露下列高级内容：

• 手动订阅配置管理
• 复杂代理组调试
• 高级路由和内核参数
• 与一键 VPN 连接无关的扩展功能

---

平台支持

平台	最低系统	发布形态	说明
Android	Android 6.0	APK	使用系统 VPN 权限
iOS	iOS 15	IPA	侧载安装，推荐 AltStore / SideStore
macOS	macOS 12	DMG	Universal，支持 Intel 和 Apple Silicon
Windows	Windows 10 1903+ x64	EXE / ZIP	安装版和便携版
Linux	主流 x86_64 桌面发行版	AppImage	免安装运行

---

下载

正式版通过 GitHub Releases 分发：

• Release 页面：https://github.com/onesyue/yuelink-lite/releases
• 稳定版 tag：vX.Y.Z
• 预发布 tag：pre 或 vX.Y.Z-pre

产物说明

文件	平台	用途
YueLink-Lite-<version>-android-universal.apk	Android	推荐下载，适合绝大多数 Android 设备
YueLink-Lite-<version>-android-arm64-v8a.apk	Android	64 位 ARM 设备
YueLink-Lite-<version>-android-armeabi-v7a.apk	Android	32 位 ARM 设备
YueLink-Lite-<version>-android-x86_64.apk	Android	x86_64 设备或模拟器
YueLink-Lite-<version>-ios.ipa	iOS	iOS 侧载包
YueLink-Lite-<version>-macos-universal.dmg	macOS	Intel 和 Apple Silicon 通用安装包
YueLink-Lite-<version>-windows-amd64-setup.exe	Windows	推荐下载，标准安装版
YueLink-Lite-<version>-windows-amd64-portable.zip	Windows	免安装便携版
YueLink-Lite-<version>-linux-amd64.AppImage	Linux	x86_64 AppImage
YueLink-Lite-<version>-SHA256SUMS	全平台	所有正式产物的 SHA-256 汇总校验

选择建议

• Android 用户优先下载 android-universal.apk。
• Windows 用户优先下载 windows-amd64-setup.exe。
• macOS 用户下载 macos-universal.dmg，无需区分芯片。
• Linux 用户下载 linux-amd64.AppImage。
• iOS 用户推荐使用 AltStore 或 SideStore 安装 IPA。

---

安装

Android

1. 下载 YueLink-Lite-<version>-android-universal.apk。
2. 允许浏览器或文件管理器安装未知来源应用。
3. 首次连接时同意系统 VPN 权限。

iOS

1. 下载 YueLink-Lite-<version>-ios.ipa。
2. 使用 AltStore 或 SideStore 安装。
3. 首次连接时同意添加 VPN 配置。

TrollStore 可以安装 IPA，但系统可能不信任 PacketTunnel 网络扩展，导致界面显示已连接而实际没有 VPN 流量。需要稳定 VPN 连接时，请使用 AltStore 或 SideStore 自签安装。

macOS

1. 打开 YueLink-Lite-<version>-macos-universal.dmg。
2. 将 YueLink Lite.app 拖入 Applications。
3. 若系统提示无法验证开发者，右键应用选择打开，或运行 DMG 内的 修复无法打开.command。

Windows

• 安装版：运行 YueLink-Lite-<version>-windows-amd64-setup.exe。
• 便携版：解压 YueLink-Lite-<version>-windows-amd64-portable.zip 后运行应用。

首次启动可能出现 Windows SmartScreen 提示，选择“更多信息”后点击“仍要运行”即可。

Linux

chmod +x YueLink-Lite-<version>-linux-amd64.AppImage
./YueLink-Lite-<version>-linux-amd64.AppImage

---

轻量化说明

YueLink Lite 的正式产物按轻量分发处理：

• 发布包默认不内置大型 GeoIP / GeoSite / MMDB 数据。
• Windows 安装器不捆绑 VC++ Redistributable，缺失时按需在线安装。
• 不打包 Lite 主流程不需要的 WebView、多媒体和扫码运行库。
• Release 页面只上传安装产物和统一 SHA-256 汇总文件，避免重复附件。

---

应用标识

YueLink Lite 使用独立应用标识和本地配置：

项	值
Android package	com.yueto.yuelink.lite
iOS/macOS bundle	com.yueto.yuelink.lite
iOS PacketTunnel	com.yueto.yuelink.lite.PacketTunnel
App Group	group.com.yueto.yuelink.lite
配置文件	yuelink_lite.yaml

---

从源码运行

环境

工具	版本
Flutter	>= 3.38.4，CI 使用 3.41.7
Dart	随 Flutter 安装
Go	>= 1.22
Xcode	>= 15，用于 iOS / macOS
Android NDK	r27，用于 Android 原生构建

运行 UI

git clone --recursive https://github.com/onesyue/yuelink-lite.git
cd yuelink-lite
flutter pub get
flutter run

本地没有原生内核时，应用会进入 mock mode，用模拟连接、地区、流量和账户数据驱动界面。

初始化子模块

git submodule update --init --recursive

core/patches/*.patch 会在本地 dart setup.dart build 和 CI 构建时自动应用。

构建示例

# Android
dart setup.dart build -p android
dart setup.dart install -p android
flutter build apk --release

# iOS
dart setup.dart build -p ios
dart setup.dart install -p ios
flutter build ios --release

# macOS
dart setup.dart build -p macos -a arm64
dart setup.dart build -p macos -a x86_64
dart setup.dart install -p macos
flutter build macos --release

# Windows
dart setup.dart build -p windows -a amd64
dart setup.dart install -p windows
flutter build windows --release

# Linux
dart setup.dart build -p linux -a amd64
dart setup.dart install -p linux
flutter build linux --release

检查

flutter analyze --no-fatal-infos --no-fatal-warnings
flutter test

---

发布

Release workflow 在推送 tag 时构建全平台产物：

• vX.Y.Z：正式版，刷新 update.json
• pre：预发布，刷新 update-pre.json
• vX.Y.Z-pre：版本化预发布

发布流程会构建 Android / iOS / macOS / Windows / Linux，生成安装产物、SHA-256 汇总、Release notes 和 updater manifest。

---

许可证

MIT