安装文档 · Lumina

01 简介

Lumina 是一个基于 Vue 3 从零开发的 NewAPI 前端项目，采用液态玻璃设计语言，无需修改后端即可直接替换原有前端使用。

技术栈 Vue 3 + Vite + 原生 CSS

兼容后端 NewAPI / One API

演示站 https://api.l11.top

β 测试版下载

测试版本含有水印及版权信息，请勿用于商用。如需商用授权请联系作者 QQ：226493076

https://docs.l11.top/dow/Lumina测试包.zip

02 配置说明

暂无

03 部署上线

推荐宝塔面板部署

1

新建网站

进入宝塔面板 → 网站 → 添加站点，填写域名，类型选择 HTML 静态项目，创建完成后记录网站根目录路径。

2

上传前端源码

将 Lumina 构建产物（dist/ 目录下所有文件）上传至网站根目录，确保 index.html 位于根目录下。

3

修改 Nginx 配置

进入宝塔面板 → 网站设置 → 配置文件，在现有 server { } 块内添加以下配置，将 https://newapi的链接 替换为你的 NewAPI 后端地址：

nginx

# SPA 路由支持
location / {
    try_files $uri $uri/ /index.html;
}

# API 反向代理
location /api/ {
    proxy_pass https://newapi的链接/api/;
    proxy_set_header Host newapi的域名;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_ssl_server_name on;
}

# OpenAI 兼容接口代理
location /v1/ {
    proxy_pass https://newapi的链接/v1/;
    proxy_set_header Host newapi的域名;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_ssl_server_name on;
}

4

保存并重载 Nginx

点击保存，宝塔会自动检测配置语法并重载 Nginx。访问你的域名即可看到 Lumina 界面 🎉

⚠️ 注意 proxy_set_header Host 填写 NewAPI 后端的实际域名，不要填前端域名

💡 提示部署后如出现 API 请求失败，检查 proxy_pass 地址末尾是否带 /

04 常见问题

暂无

💬

遇到问题？联系作者

QQ: 226493076 · 演示站：api.l11.top