60 lines
1.0 KiB
Markdown
60 lines
1.0 KiB
Markdown
|
# OneinAI 文档站
|
|||
|
|
|
|||
|
|
基于 VitePress 构建的文档站点。
|
|||
|
|
|
|||
|
|
## 本地启动
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 安装依赖
|
|||
|
|
npm install
|
|||
|
|
|
|||
|
|
# 启动开发服务器
|
|||
|
|
npm run docs:dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
访问 http://localhost:5173 查看效果。
|
|||
|
|
|
|||
|
|
## 构建
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run docs:build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
构建产物在 `apidoc/.vitepress/dist/` 目录。
|
|||
|
|
|
|||
|
|
## 部署到宝塔
|
|||
|
|
|
|||
|
|
### 1. 本地构建
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run docs:build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 宝塔添加站点
|
|||
|
|
|
|||
|
|
1. 宝塔面板 → **网站** → **添加站点**
|
|||
|
|
2. 填写域名，PHP 版本选 **纯静态**
|
|||
|
|
3. 记住站点根目录路径（如 `/www/wwwroot/你的域名/`）
|
|||
|
|
|
|||
|
|
### 3. 上传文件
|
|||
|
|
|
|||
|
|
将本地 `apidoc/.vitepress/dist/` 目录下的**所有文件**上传到站点根目录。
|
|||
|
|
|
|||
|
|
可使用宝塔文件管理器或 FTP 工具上传。
|
|||
|
|
|
|||
|
|
### 4. 配置 Nginx
|
|||
|
|
|
|||
|
|
进入站点 **设置 → 配置文件**，找到 `location /` 块，修改为：
|
|||
|
|
|
|||
|
|
```nginx
|
|||
|
|
location / {
|
|||
|
|
try_files $uri $uri/ /index.html;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
保存后重载 Nginx，站点即可正常访问。
|
|||
|
|
|
|||
|
|
### 5. 后续更新
|
|||
|
|
|
|||
|
|
每次修改文档后重新执行构建，将新的 `dist/` 内容覆盖上传即可。
|