amnezia-vpn/amnezia-client 源码：https://github.com/amnezia-vpn/amnezia-client # Amnezia VPN ### 自建VPN的最佳客户端 构建状态 (https://github.com/amnezia-vpn/amnezia-client/actions/workflows/deploy.yml?query=branch:dev) Gitpod 即开即用 (https://gitpod.io/#https://github.com/amnezia-vpn/amnezia-client) ### English | Русский (https://github.com/amnezia-vpn/amnezia-client/blob/dev/README_RU.md) Amnezia (https://amnezia.org?utm_source=github&utm_campaign=amnezia_website-readme-en) 是一个开源 VPN 客户端，其核心功能允许您在自己的服务器上部署 VPN 服务器。 图片 (https://amnezia.org) ### 官方网站 (https://amnezia.org?utm_source=github&utm_campaign=amnezia_website-readme-en) | 备用网站链接 (https://storage.googleapis.com/amnezia/amnezia.org?utm_source=github&utm_campaign=amnezia_website-readme-en-mirror) | 文档 (https://docs.amnezia.org) | 故障排除 (https://docs.amnezia.org/troubleshooting) > [!TIP] > 如果 Amnezia 官网 (https://amnezia.org?utm_source=github&utm_campaign=amnezia_website-readme-en) 在您所在地区被屏蔽，您可以使用备用网站链接 (https://storage.googleapis.com/amnezia/amnezia.org?utm_source=github&utm_campaign=amnezia_website-readme-en-mirror)。 所有发布版本 (https://github.com/amnezia-vpn/amnezia-client/releases) ## 特性 - 极其易用 - 只需输入您的 IP 地址、SSH 登录名和密码，Amnezia 便会自动在您的服务器上安装 VPN Docker 容器并连接 VPN。 - 经典 VPN 协议：OpenVPN、WireGuard 和 IKEv2 协议。 - 支持流量伪装（混淆）的协议：基于 Cloak (https://github.com/cbeuw/Cloak) 插件的 OpenVPN、Shadowsocks（OpenVPN over Shadowsocks）、AmneziaWG (https://docs.amnezia.org/documentation/amnezia-wg/) 和 XRay。 - 支持分流隧道 - 添加任意站点，仅对这些站点启用 VPN；或添加应用（仅限 Android 和桌面端）。 - 支持 Windows、macOS、Linux、Android、iOS 平台。 - 支持在 Keenetic 测试版固件 (https://docs.keenetic.com/ua/air/kn-1611/en/6319-latest-development-release.html#UUID-186c4108-5afd-c10b-f38a-cdff6c17fab3_section-idm33192196168192-improved) 上配置 AmneziaWG 协议。 ## 链接 - https://amnezia.org/?utm_source=github&utm_campaign=amnezia_website-read - 项目官网 | 备用链接（镜像）(https://storage.googleapis.com/amnezia/amnezia.org?utm_source=github&utm_campaign=amnezia_website-read) - https://docs.amnezia.org/?utm_source=github&utm_campaign=amnezia_website-read - 文档 | 备用链接（镜像）(https://storage.googleapis.com/amnezia/docs?utm_source=github&utm_campaign=amnezia_website-read) - https://www.reddit.com/r/AmneziaVPN - Reddit - https://telegram.me/amnezia_vpn_en - Telegram 支持频道（英文） - https://telegram.me/amnezia_vpn_ir - Telegram 支持频道（波斯语） - https://telegram.me/amnezia_vpn_mm - Telegram 支持频道（缅甸语） - https://telegram.me/amnezia_vpn - Telegram 支持频道（俄语） - 获取 6 或 12 个月的高级版 (https://storage.googleapis.com/amnezia/pay?utm_source=github&utm_campaign=ampay-read) ## 技术 AmneziaVPN 使用了以下开源项目： - OpenSSL (https://www.openssl.org/) - OpenVPN (https://openvpn.net/) - Qt (https://www.qt.io/) - LibSsh (https://libssh.org) - WireGuard (https://www.wireguard.com/) - Xray-core (https://xtls.github.io/en/) - Conan (https://conan.io/) - 以及其他…… ## 帮助我们进行翻译 下载最新的翻译文件。进入 “Actions” 标签页 (https://github.com/amnezia-vpn/amnezia-client/actions?query=is%3Asuccess+branch%3Adev)，点击第一行。然后滚动到 “Artifacts” 区域，下载 “AmneziaVPN_translations”。解压该文件。每个 *.ts 文件包含对应语言的字符串。翻译或修正一个或多个 *.ts 文件中的字符串，然后将它们提交回本仓库的 client/translations 文件夹。您可以通过网页界面或您熟悉的任何其他方式完成此操作。 ## 检出源代码 检出仓库后，请确保拉取所有子模块。 bash git submodule update --init --recursive ## 开发指南 想要贡献代码？欢迎！ ### 构建依赖 * CMake (https://cmake.org/download/) * 编译器和底层构建系统，根据目标平台而定： - [Linux] 任意 make 和 gcc - [Apple] Xcode (https://developer.apple.com/xcode/) 或 Xcode 命令行工具 (https://developer.apple.com/xcode/) - [Windows] Visual Studio 2022 (https://aka.ms/vs/17/release/vs_community.exe) 或 VS 2022 Build Tools (https://aka.ms/vs/17/release/vs_buildtools.exe) - [Android] Android SDK 和 Ninja (https://ninja-build.org/) * Qt 6.10+ (https://www.qt.io/download-open-source)，包含以下模块： - 用于目标平台（桌面端/Android/iOS）的 Core 模块 - Qt 5 兼容模块 - Qt Remote Objects * Conan (https://conan.io/downloads) 包管理器 - 在 macOS 上，只需使用 homebrew 或在项目根目录的 .venv 中安装即可 - 其他系统必须将其置于 PATH 中 * （可选）安装程序依赖： - [Windows/Linux] Qt Installer Framework (https://www.qt.io/download-open-source) - [Windows] WIX toolset (https://github.com/wixtoolset/wix/releases) ### 使用脚本构建项目 * 运行位于 deploy 目录下的脚本 * 通常，如果依赖项位于默认安装路径，脚本会自动找到它们。 * 如果路径不同，请使用以下变量指定： - QT_INSTALL_DIR - Qt 根安装文件夹 - QT_ROOT_PATH - Qt 框架根目录 - QIF_ROOT_PATH - Qt Installer Framework 根路径 - ANDROID_HOME - Android SDK 根文件夹路径 - 以及其他变量。请查阅脚本以获取更多信息。 Unix 类系统： bash # 为主机平台构建可执行文件 deploy/build.sh # 或直接 deploy/build.sh # 为主机平台构建可执行文件和安装程序 deploy/build.sh --installer all # 构建 Android APK 和 AAB deploy/build.sh -t android --aab # 查看帮助 deploy/build.sh -h Windows： batch :: 为 Windows 构建可执行文件 deploy/build.bat :: 为 Windows 构建带有 IFW 安装程序的可执行文件 deploy/build.bat --installer ifw :: 为 Windows 构建带有 IFW 和 WIX 安装程序的可执行文件 deploy/build.bat --installer ifw --installer wix :: 或直接 deploy/build.bat --installer all ### 在 IDE 中开发项目 * 您可以使用任何能够正确处理 CMake 和 Qt 工具包以执行配置和构建步骤，并能良好导航代码的 IDE。例如： - Qt Creator - 安装了 Qt 扩展包 的 Visual Studio Code - 等等 * 要使用 Xcode，您需要先通过 cmake 配置项目。最简单的方法是使用 Qt Creator 进行配置。然后使用 Xcode 打开构建文件夹中的 AmneziaVPN.xcodeproj 文件。请注意，更改的任何文件都不会自动保存——实际更改的文件保存在构建目录中。如有必要，请手动复制它们。 * Android Studio 可以类似方式使用——只需通过 cmake 手动配置项目，或使用 Qt Creator 配置。然后在 Android Studio 中打开 /client/android-build 文件夹。不要忘记复制更改——您所做的所有操作实际上都保存在构建目录下。 ### 安装 Android SDK * Android SDK 可以通过以下方式安装： - 使用 Qt Creator。进入 Preferences->SDKs - 使用 Android Studio。默认情况下，安装过程中会自动安装必要的 SDK - 手动使用 sdk-manager。详情请查阅此页面 (https://developer.android.com/tools) ## 许可证 本项目基于 GNU General Public License v3.0 许可证（参见 LICENSE），并且包含以各自条款分发的第三方组件（参见 THIRD_PARTY_LICENSES.md）。 ## 捐赠 Patreon: https://www.patreon.com/amneziavpn Bitcoin: bc1qmhtgcf9637rl3kqyy22r2a8wa8laka4t9rx2mf USDT BEP20: 0x6abD576765a826f87D1D95183438f9408C901bE4 USDT TRC20: TELAitazF1MZGmiNjTcnxDjEiH5oe7LC9d XMR: 48spms39jt1L2L5vyw2RQW6CXD6odUd4jFu19GZcDyKKQV9U88wsJVjSbL4CfRys37jVMdoaWVPSvezCQPhHXUW5UKLqUp3 TON: UQDpU1CyKRmg7L8mNScKk9FRc2SlESuI7N-Hby4nX-CcVmns ## 致谢 本项目使用 BrowserStack 进行测试。我们感谢 BrowserStack (https://www.browserstack.com) 对本项目的支持。