Skip to content

常见问题

安装部署

Q: 支持哪些操作系统?

A: NNIPMS 推荐在 Linux 系统上部署(Ubuntu 20.04+、Debian 11+、CentOS 8+),通过 Docker 容器化方式运行。

Q: 需要多少服务器资源?

A: 最低配置要求:

  • CPU: 2 核
  • 内存: 4 GB
  • 磁盘: 20 GB

推荐配置:

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

Q: 支持哪些数据库?

A: 目前支持:

  • PostgreSQL 14+
  • MySQL 8.0+

推荐使用 PostgreSQL,性能和功能更优。

Q: 如何升级到新版本?

A: 使用 Docker Compose 升级:

bash
cd docker-compose/postgres
docker compose pull
docker compose up -d

功能使用

Q: 如何批量导入端口映射?

A: 支持通过 Excel 批量导入:

  1. 进入「端口映射」页面
  2. 点击「批量导入」
  3. 下载模板文件
  4. 按模板填写数据
  5. 上传文件并确认

Q: 端口映射不生效怎么办?

A: 请检查以下几点:

  1. 确认端口映射状态为「启用」
  2. 检查目标服务器是否正常运行
  3. 检查防火墙规则是否放行
  4. 验证网络连通性(ping/telnet)
  5. 查看系统日志获取详细错误

Q: 如何配置 SSL 证书?

A: 通过 Nginx 反向代理配置 SSL:

nginx
server {
    listen 443 ssl;
    server_name nnipms.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:12338;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

安全相关

Q: 如何修改默认管理员密码?

A: 修改步骤:

  1. 使用默认账号登录
  2. 点击右上角用户名
  3. 选择「个人设置」
  4. 点击「修改密码」
  5. 输入新密码并保存

安全提示

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

Q: 忘记密码怎么办?

A: 可通过命令行重置管理员密码:

bash
# 进入后端容器
docker exec -it nnipms-backend /bin/sh

# 执行重置命令
./nnipms --admin-reset --admin-password newpass123

Q: 如何限制管理后台访问 IP?

A: 配置步骤:

  1. 进入「安全策略」>「IP白名单」
  2. 添加允许的 IP 地址或网段
  3. 选择生效范围为「管理后台」
  4. 保存配置

性能优化

Q: 系统运行缓慢怎么办?

A: 优化建议:

  1. 检查服务器资源使用情况
  2. 优化数据库查询(添加索引)
  3. 启用缓存功能
  4. 调整连接池大小
  5. 定期清理历史日志

Q: 如何查看系统性能指标?

A: 查看方式:

  1. 进入「系统监控」页面
  2. 查看 CPU、内存、磁盘使用率
  3. 查看数据库连接数
  4. 查看请求响应时间

故障排查

Q: 服务无法启动怎么办?

A: 排查步骤:

  1. 检查配置文件是否正确
  2. 检查数据库连接是否正常
  3. 检查端口是否被占用
  4. 查看日志文件获取错误信息
  5. 检查系统资源是否充足

Q: 数据库连接失败怎么办?

A: 检查以下配置:

  1. 数据库服务是否启动
  2. 数据库地址和端口是否正确
  3. 用户名和密码是否正确
  4. 数据库用户权限是否足够
  5. 防火墙是否放行数据库端口

Q: 如何查看系统日志?

A: 使用 Docker 命令查看日志:

bash
# 查看后端日志
docker logs -f nnipms-backend

# 查看所有容器日志
docker compose logs -f

也可在 Web 界面「日志审计」中查看。

Q: 如何备份和恢复数据?

A: 备份方式:

bash
# PostgreSQL 备份
docker exec -t nnipms-postgres pg_dump -U nnipms_user nnipms_db > backup.sql

# MySQL 备份
docker exec -t nnipms-mysql mysqldump -u nnipms_user -p nnipms_db > backup.sql

恢复方式:

bash
# PostgreSQL 恢复
cat backup.sql | docker exec -i nnipms-postgres psql -U nnipms_user -d nnipms_db

其他问题

Q: 如何获取技术支持?

A: 请联系技术支持邮箱:support@nnipms.liumou.site