shensheshou/开发文档/8、部署/启动与部署脚本.md

神射手 - 启动与部署脚本

📅 从 package.json 与项目配置提取 | 2026-01-31

---

一、开发环境启动

1.1 前置条件

# 1. MongoDB 运行
docker ps | grep mongo
# datacenter_mongodb  Up 0.0.0.0:27017->27017/tcp

# 2. Node.js 环境
node -v   # v20+
npm -v    # 或 pnpm

1.2 启动命令

# 进入项目目录
cd /Users/karuo/Documents/开发/2、私域银行/神射手

# 安装依赖（首次）
npm install
# 或 pnpm install

# 启动开发服务器（默认 3000，指定 3001）
npm run dev -- -p 3001

# 访问
open http://localhost:3001

1.3 package.json 脚本

{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "next lint"
  }
}

---

二、生产构建

# 构建
npm run build

# 启动生产服务（默认 3000）
npm run start

---

三、环境变量

# .env.local（可选）
MONGODB_URI=mongodb://admin:admin123@localhost:27017/?authSource=admin
GATEWAY_URL=http://localhost:8000   # 卡若AI网关

---

四、端口说明

服务	端口	说明
神射手前端	3001	Next.js dev
MongoDB	27017	Docker
卡若AI网关	8000	FastAPI

---

五、关联文档

• Next.js自动化部署流程.md
• ../9、手册/快速使用手册.md