3.4 安装验证与首次启动

3.4.1 安装验证

完成安装后，建议按以下步骤确认安装是否成功：

1. 版本确认
打开终端（或命令提示符），执行：

软件名 --version

应返回类似 v3.4.2 的版本号信息。如提示"命令未找到"，请检查环境变量是否配置正确（Windows需重启终端，Linux/macOS需执行 source ~/.bashrc）。

2. 核心文件检查
确认安装目录下包含以下关键文件：

• bin/ 或 exe 可执行文件
• config/ 配置文件目录
• logs/ 日志目录（首次启动前可能为空）

3. 端口占用检查（如适用）
若软件需要监听端口，提前检查是否被占用：

# Linux/macOS
lsof -i :8080

# Windows
netstat -ano | findstr :8080

3.4.2 首次启动

启动方式

• 前台启动（适合首次测试，便于查看日志）：

  软件名 start --foreground
  

或双击 start.bat（Windows）/start.sh（Linux）

• 后台启动（正式环境）：

  软件名 service start
  

首次启动必做事项

1. 初始化配置：首次启动会自动生成 config/config.ini，请根据提示修改默认密码和监听地址
2. 防火墙放行：如使用云服务器，需在安全组开放对应端口（如 8080, 3306 等）
3. 日志观察：密切关注控制台或 logs/startup.log，确认无 ERROR 级别报错

验证启动成功
访问 http://localhost:8080/health（或软件提供的健康检查接口），应返回 {"status":"ok"} 或类似成功标识。

常见问题

• 启动后立刻退出：通常是端口冲突或权限不足，查看 logs/error.log 获取具体原因
• 无法远程访问：检查是否绑定在 127.0.0.1，需修改为 0.0.0.0 或具体IP
• 内存不足：调整启动参数中的 -Xmx 值（Java类应用）或降低并发配置

提示：首次启动建议保持前台运行模式，确认无异常后再配置为系统服务开机自启。