Luna AI换脸并不是一个打开网页、上传照片就能直接使用的在线换脸工具，它更接近一套可以自行部署的 AI 换脸应用系统。开发者可以用它搭建微信小程序和管理后台，再接入第三方换脸 API，用于 AI 换脸、AI 写真、AI 证件照等场景。
这个项目目前需要区分两个版本：早期的 Luna Swapping 已停止维护并被 GitHub 归档，开发者已经将主要方向转到轻量化的 Luna Lite。如果现在准备部署，更适合直接从 Lite 版本开始，而不是继续使用旧版代码。
Luna AI换脸是什么？
Luna AI换脸是一套面向 AI 换脸应用的应用层系统，目前主要维护的是 Luna Lite 版本。项目包含服务端、管理后台和微信小程序，可用于管理换脸模板、数字分身和生成任务，并通过 API 接入第三方换脸算法。
它本身不包含完整的底层换脸模型，更接近一套可自行部署和二次开发的“AI 换脸小程序源码”，而不是普通用户直接上传照片使用的在线换脸网站。
Luna Swapping 已停更，Luna Lite 接替旧版
旧版 Luna Swapping 已经停止维护，仓库也进入归档状态。现在如果准备重新部署 Luna，更合适的是直接使用后续的 Luna Lite，而不是继续在旧版上搭建新项目。
Luna Lite 不是单纯给旧版做一次升级，而是把整套系统重新做轻了。合辑模板、多对多关联、玩法策略和多人合照等复杂功能被拿掉，重点转向换脸模板、数字分身、小程序和统一的算法 API 接入。
技术栈也跟着换了一轮。旧版后端使用 ThinkPHP 6，Lite 改为 Laravel 11，配套 PHP 8.2、MySQL 8.0、Vue 3、TypeScript、Element Plus、Vite 和 uni-app。管理后台基于 Likeadmin-Laravel，部署时还提供了 Web 安装引导，整体更偏向拿来二次开发。
| 项目 | Luna Swapping | Luna Lite |
|---|---|---|
| 维护状态 | 已停止维护并归档 | 仓库仍开放 |
| 后端框架 | ThinkPHP 6 | Laravel 11 |
| 产品方向 | 功能较多的换脸业务系统 | 更轻量的换脸应用框架 |
| 算法接入 | 依赖外部算法服务 | 统一 API 接入层，可接第三方或自建模型 |
| 多人换脸 | 旧版提供 | 目前仍在 TODO |
| 支付 | 已有充值、会员等设计 | 微信小程序支付仍在 TODO |
| 安装 | 服务端、后台和小程序分别部署 | 提供 Web 安装引导 |
Luna AI换脸目前可以做什么？
AI换脸、AI写真和AI证件照
Luna Lite 仍然保留 AI 换脸应用的核心框架，可以围绕 AI 写真、AI 证件照、表情图片以及不同风格的人像模板搭建应用。
需要注意，这里的“支持 AI 换脸”并不意味着仓库中包含完整的换脸大模型。Luna 主要负责应用层和业务流程，真正的图片生成功能仍需要外部算法服务。
数字分身
项目提供数字分身相关流程。根据官方说明，用户可以通过正脸照片创建个人数字分身，并在自己的账户中进行管理或删除。
这类功能会涉及人脸图片和生物特征相关数据，实际部署时不能只关注生成效果，还需要考虑数据保存位置、第三方 API 传输以及当地适用的隐私和数据保护要求。
换脸模板管理
管理员可以在后台管理换脸模板，包括模板底图、排序和页面展示等内容。
当前设计并不是完全开放给普通用户任意上传目标人物图片。官方 FAQ 明确说明，目标底图主要由系统管理员在后台进行管理，这种方式也更方便运营方控制内容来源和使用范围。
微信小程序
Luna Lite 的代码结构包含微信小程序端，可以将换脸功能做成微信小程序，而不只是普通 Web 页面。
如果需要自行修改小程序，官方项目使用 uni-app。开发环境需要配置自己的微信小程序 AppID，并将小程序端连接到已经部署好的 Luna 服务端。
统一的换脸 API 接入层
新版比较有价值的一点，是重新封装了换脸 API 接入层。
官方当前提供的算法能力已经下线，Lite README 中使用商汤科技的换脸 API 作为现有方案，同时也允许开发者自行接入其他第三方 API 或自己的算法模型。
这意味着 Luna 更适合作为“AI 换脸业务系统外壳”，而不是把它理解成一个开箱即用的开源换脸模型。
Luna AI换脸的算法开源吗？
Luna 开源的重点是应用层，包括服务端、管理后台和微信小程序，真正负责换脸的人脸处理模型并不包含在项目里。
实际使用时，Luna 需要通过 API 接入商汤或其他第三方换脸服务，也可以由开发者接入自己的模型。因此，把 Luna 部署到自己的服务器，并不代表图片处理一定在本地完成；数据是否会传到外部服务，取决于你接入的算法方案。
如果希望把整套流程放在本地或内网运行，就需要自行准备换脸模型并完成接口适配，Luna 本身并不会附带本地换脸模型。
Luna AI换脸如何部署？
Luna Lite 的部署门槛不算低，但流程已经做得比较完整。项目提供 Release 安装包和 Web 安装引导，不需要自己重新打包全部前端代码。
运行环境主要包括：
- PHP 8.2
- MySQL 8.0
- Nginx
- Redis
- PHP fileinfo 扩展
- PHP redis 扩展
- 阿里云 OSS
- 微信小程序账号
- 可用的换脸算法 API
部署时可以直接下载 Luna Lite 的 Release 安装包，把站点运行目录指向 public。首次访问网站后会进入安装引导，依次完成环境检查、数据库连接、Redis、管理员账号和数据初始化。
后台安装完成后，还要继续配置微信小程序、对象存储和换脸算法 KEY，才能真正跑通从用户上传到生成结果的完整流程。
阿里云 OSS 不是可选项
Luna Lite 当前的官方方案依赖阿里云 OSS，原因是数字分身中的人脸裁剪会调用 OSS 的图片处理能力。
这也意味着，Luna Lite 虽然可以部署在自己的服务器上，但默认方案并不是纯本地运行。图片存储和换脸处理仍可能涉及外部云服务。
如果目标是把存储、图片处理和模型推理都放在本地或内网环境，就需要自行替换 OSS 相关逻辑，并接入自己的换脸模型或内部算法服务。
Luna Lite 的界面和管理方式
Luna Lite 现在还有哪些限制？
Luna Lite 已经把应用层框架搭得比较完整，但距离“装完就能直接上线”还有一些差距。现在比较实际的限制主要集中在算法、支付、多人换脸和项目维护这几块。
- 算法和存储并不是全本地：默认方案仍要接第三方换脸 API，并依赖阿里云 OSS。想改成自己的模型或内网方案，需要继续做接口和存储适配。
- 支付功能还没做完：微信小程序支付、充值和点数购买目前仍在开发计划里。
- 多人换脸还没回到 Lite：旧版曾支持多人合照，Lite 精简后把这部分拿掉了，目前仍处于 TODO 状态。
- 项目更新比较慢：截至 2026 年 10 月，Lite 主仓库没有归档，但正式 Release 仍停留在 2025 年 1 月的 v1.0.0，主分支最近一次推送也是 2025 年 1 月。
如果只是拿来做二次开发、原型或内部验证，这些限制不一定是问题；如果准备长期上线，就要先确认算法接口、支付、存储和后续维护能不能自己接住。
Luna Lite 的内容限制
项目 FAQ 明确限制涉黄、涉政、明星和公众人物等内容，并且默认不允许普通用户自行上传目标底图，目标模板由管理员后台管理。
由于实际换脸可能调用第三方算法 API，部署方还需要单独确认照片会发送到哪些服务、如何保存以及如何删除。Luna 仓库本身并没有完整回答这些数据处理问题。
Luna Lite 适合什么场景？
Luna Lite 更适合已经有服务器和基础开发能力，希望搭建 AI 写真、AI 换脸或证件照小程序的开发者和团队。它提供现成的用户端、管理后台、模板系统和换脸 API 接入层，可以减少应用层开发工作。
如果只是想上传照片直接换脸，它并不合适；Luna Lite 仍需要服务器、阿里云 OSS 和外部换脸算法服务。
Luna AI换脸常见问题
Luna Lite 可以完全离线运行吗？
按照官方当前部署方案不能直接视为完全离线系统。数字分身依赖阿里云 OSS 图片处理，换脸也依赖第三方 API；如果需要全部在本地或内网处理，需要自行替换这些外部服务。
Luna Lite 支持 Docker 部署吗？
官方目前主要提供 PHP 8.2、MySQL、Redis、Nginx 的部署文档，并以宝塔面板作为示例，没有提供官方 Docker 部署方案。
Luna Lite 还在积极维护吗？
主仓库目前仍未归档，但更新频率已经较低。截至 2026 年 10 月，可见的正式 Release 仍为 2025 年 1 月发布的 v1.0.0，主分支最近一次推送为 2025 年 1 月 30 日。
Luna AI换脸项目地址
Luna Lite 主仓库：https://github.com/loxi-opensource/luna-lite-server
Luna Lite 小程序：https://github.com/loxi-opensource/luna-lite-uniapp
Luna Lite 管理后台：https://github.com/loxi-opensource/luna-lite-admin
旧版 Luna Swapping：https://github.com/loxi-opensource/luna-swapping
评论(0)