部署指南

DocParse4AI 支持一键脚本部署，使用 uv 管理 Python 环境。

系统要求

Linux + NVIDIA GPU（推荐 3090/4090，≥24GB 显存）
Python 3.10、Node.js 20+
磁盘：模型权重约 15GB+

1. 安装环境

cd /path/to/lwsomark
bash scripts/setup-uv.sh

自动安装：FastAPI、MonkeyOCR、PaddlePaddle、LMDeploy、vl_ocr 依赖。

2. 启动全部服务

bash scripts/run-all.sh

启动：vl_ocr 布局(:30017) + OCR(:30018) + API(:8088) + 前端(:3000)

3. 服务端口

服务	端口
Next.js 前端	3000
FastAPI	8088
K12 布局	30017
K12 OCR	30018

4. GPU 分配

通过环境变量指定 GPU（避免显存冲突）：

LAYOUT_GPU=5 OCR_GPU=5 MONKEY_GPU=7 bash scripts/run-all.sh

5. Redis 异步队列（可选）

export REDIS_URL=redis://127.0.0.1:6379/0
cd lwsomark-api && python worker.py

6. 对外域名（生产）

通过 Nginx 网关将 HTTPS 域名反代到内网服务，对外 API 使用域名而非 IP：

# 站点与 API（用户可见）
https://www.docparse4ai.com
https://www.docparse4ai.com/api/v1

# 前端环境变量（构建/启动时）
NEXT_PUBLIC_SITE_URL=https://www.docparse4ai.com
API_URL=http://127.0.0.1:8088   # 仅服务端代理，不对外暴露

# API 用量接口返回的控制台链接
LWSOMARK_DASHBOARD_URL=https://www.docparse4ai.com/console/dashboard

网关配置参考 scripts/nginx/lwsomark-gateway.conf。

7. 停止服务

bash scripts/stop-all.sh

私有化咨询

如需定制场景、多机部署或企业授权，请通过问题反馈联系我们。