快速开始

环境要求

在开始之前，请确保您的系统满足以下要求：

最低配置

• 操作系统: Linux (推荐 Ubuntu 20.04+)
• CPU: 2 核
• 内存: 4 GB
• 磁盘: 20 GB 可用空间
• Docker Engine: 24.0+
• Docker Compose: 2.20+

推荐配置

• CPU: 4 核及以上
• 内存: 8 GB 及以上
• 磁盘: SSD 100 GB 及以上

快速部署

1. 创建部署目录

mkdir nnipms && cd nnipms
mkdir -p config data/postgres data/valkey log

2. 创建 docker-compose.yml

name: nnipms

services:
  db:
    image: postgres:18.4-alpine
    container_name: nnipms-postgres
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD: root123
      POSTGRES_USER: nnipms_user
      POSTGRES_DB: nnipms_db
    ports:
      - "5432:5432"
    volumes:
      - ./data/postgres:/var/lib/postgresql/data

  valkey:
    image: valkey/valkey:9-alpine
    container_name: nnipms-valkey
    restart: unless-stopped
    ports:
      - "6379:6379"
    volumes:
      - ./data/valkey:/data

  backend:
    image: ccr.ccs.tencentyun.com/nnipms/backend:latest
    container_name: nnipms-backend
    restart: unless-stopped
    network_mode: host
    depends_on:
      db:
        condition: service_healthy
      valkey:
        condition: service_healthy
    environment:
      CORS_ORIGINS: http://localhost:8848,http://127.0.0.1:8848
      DB_DRIVER: ${DB_DRIVER:-postgres}
      DB_HOST: ${DB_HOST:-127.0.0.1}
      DB_PORT: "${DB_PORT:-5432}"
      DB_USER: ${DB_USER:-nnipms_user}
      DB_PASSWORD: ${DB_PASSWORD:-Hf#XE6h2f*#HrU}
      DB_NAME: ${DB_NAME:-nnipms_db}
      DB_SSLMODE: ${DB_SSLMODE:-disable}
      VALKEY_ADDRESS: ${VALKEY_ADDRESS:-127.0.0.1}
      VALKEY_PORT: "${VALKEY_PORT:-6379}"
    volumes:
      - ./config:/app/config
      - ./log:/app/log
    command:
      - -p
      - "12339"
      - -a
      - "0.0.0.0"

  frontend:
    image: ccr.ccs.tencentyun.com/nnipms/dashboard:latest
    container_name: nnipms-frontend
    restart: unless-stopped
    network_mode: host
    depends_on:
      backend:
        condition: service_started
    environment:
      BACKEND_URL: http://127.0.0.1:12339

3. 创建数据库配置（可选）

数据库配置已通过环境变量设置（DB_HOST、DB_USER、DB_PASSWORD 等），无需额外配置。

如需使用 TOML 配置文件，创建 config/postgres.toml：

[database]
driver = "postgres"
host = "127.0.0.1"
port = 5432
username = "nnipms_user"
password = "Hf#XE6h2f*#HrU"
database = "nnipms_db"
sslmode = "disable"

[postgres]
max_idle_conns = 10
max_open_conns = 100
conn_max_lifetime = 1

4. 启动服务

docker compose up -d

3. 访问系统

打开浏览器访问：http://localhost:12338

默认管理员账号：

• 用户名: admin
• 密码: admin123456

安全提示

首次登录后请立即修改默认密码！

部署方案选择

根据实际需求选择部署方式：

方案	适用场景	说明
完整服务 - PostgreSQL	快速体验、小规模使用	含内置数据库，一键启动
完整服务 - MySQL	快速体验、MySQL 偏好	含内置数据库，一键启动
完整服务 - 前后端分离	生产环境	前后端独立容器，可独立扩展
使用外部数据库	已有数据库服务	复用现有 PostgreSQL/MySQL

详细部署文档请参考 安装部署。

下一步

• 安装部署 - 了解更详细的部署选项
• 用户指南 - 学习如何使用系统
• 功能特性 - 了解系统功能模块