5步快速部署：NeatLogic ITOM平台完整安装实战指南

5步快速部署NeatLogic ITOM平台完整安装实战指南【免费下载链接】neatlogic-itom-allNeatLogic is a progressive ITOM platform offering ITOM solutions for users of various types and sizes. It includes features like ITSM, CMDB, continuous integration, knowledge base, automation, reporting, and inspections. The platform is in active development, with upcoming additions of development and project management functionalities.项目地址: https://gitcode.com/gh_mirrors/ne/neatlogic-itom-allNeatLogic是一套渐进式IT运维管理ITOM平台致力于为不同类型和规模的企业用户提供全面的IT运维管理解决方案。作为一款开源的ITOM平台它集成了IT服务管理、配置管理数据库、自动化运维、持续集成、知识库、报表和巡检等核心功能帮助企业构建统一、高效的IT运维管理体系。通过模块化架构设计NeatLogic实现了灵活的功能扩展和定制化开发同时支持多租户部署模式满足企业级应用的复杂需求。1. 项目定位与价值主张1.1 解决企业IT运维痛点在数字化转型浪潮中企业面临着IT基础设施日益复杂、运维成本不断攀升的挑战。NeatLogic ITOM平台正是为解决这些痛点而生它提供了一站式的IT运维管理解决方案统一管理平台整合ITSM、CMDB、自动化运维、DevOps等多个运维领域模块化架构支持按需部署和功能扩展避免大而全的资源浪费开源灵活基于开源协议支持企业根据自身需求进行二次开发和定制多租户支持中间件共享数据库分租户模式适合SaaS化部署1.2 核心价值亮点NeatLogic采用分层容器化架构设计根上下文root context提供全局共享的公共Bean各模块上下文module context维护私有Bean实现模块间的隔离与单向依赖。这种设计确保了高内聚低耦合各功能模块独立开发部署互不干扰易于扩展新增模块只需实现标准接口无需修改核心代码维护简单模块间依赖清晰故障定位快速准确2. 技术架构亮点解析2.1 后端技术栈NeatLogic采用现代化的微服务架构技术栈确保系统的高性能和可扩展性技术组件版本要求作用说明JavaJDK 8后端主要开发语言Spring Boot2.x微服务框架简化配置MySQL8.0.27主数据库存储业务数据MongoDB7.x自动采集和巡检定义数据库Tomcat9.0.75Servlet容器运行Web应用Nginx1.16.1反向代理和负载均衡2.2 前端技术栈前端采用现代化的Vue.js框架提供流畅的用户体验Vue.js 3.x渐进式JavaScript框架Element UI基于Vue的UI组件库AxiosHTTP客户端处理API请求Vue Router路由管理实现单页应用2.3 项目模块化设计NeatLogic采用模块化设计理念主要模块包括模块名称功能描述neatlogic-framework基础框架模块所有子模块依赖neatlogic-tenant多租户管理模块neatlogic-web前端界面模块neatlogic-webrootTomcat部署模式主模块neatlogic-springbootSpringBoot部署模式主模块neatlogic-itsmIT服务管理模块neatlogic-cmdb配置管理数据库模块neatlogic-autoexec自动化运维模块3. 环境准备与前置条件3.1 系统要求在开始部署之前确保你的环境满足以下最低要求资源类型最低配置推荐配置操作系统CentOS 7/8/9, Ubuntu 18.04CentOS 8, Ubuntu 20.04CPU4核8核内存8GB16GB磁盘空间50GB100GBJava版本JDK 8JDK 113.2 依赖组件安装3.2.1 Docker环境配置NeatLogic支持Docker快速部署首先确保Docker环境就绪# 检查Docker版本 docker --version docker compose version # 配置Docker镜像仓库如果需要访问私有仓库 sudo vi /etc/docker/daemon.json添加以下配置到daemon.json{ insecure-registries: [harbor.neatlogic.com:8033] }重启Docker服务sudo systemctl daemon-reload sudo systemctl restart docker3.2.2 数据库准备如果选择非Docker部署需要手动安装数据库# 安装MySQL 8.0 sudo apt-get update sudo apt-get install mysql-server-8.0 # 创建数据库和用户 mysql -u root -p执行以下SQL语句CREATE DATABASE neatlogic CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER neatlogic% IDENTIFIED BY YourStrongPassword123!; GRANT ALL PRIVILEGES ON neatlogic.* TO neatlogic%; FLUSH PRIVILEGES;3.2.3 中间件安装# 安装Nginx sudo apt-get install nginx # 安装Tomcat 9 wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.75/bin/apache-tomcat-9.0.75.tar.gz tar -xzf apache-tomcat-9.0.75.tar.gz sudo mv apache-tomcat-9.0.75 /opt/tomcat4. 分步部署实战指南4.1 方案一Docker快速部署推荐4.1.1 获取部署文件从项目仓库下载Docker Compose配置文件# 克隆项目代码 git clone https://gitcode.com/gh_mirrors/ne/neatlogic-itom-all.git --recurse-submodules cd neatlogic-itom-all # 查看Docker Compose配置 cat docker-compose.yml4.1.2 启动容器服务执行以下命令启动所有服务# 拉取最新镜像 docker compose -f docker-compose.yml pull # 启动所有服务-d参数表示后台运行 docker compose -f docker-compose.yml up -d # 查看服务状态 docker compose -f docker-compose.yml ps默认启动的服务包括neatlogic-app主应用服务neatlogic-dbMySQL数据库neatlogic-mongoMongoDB数据库neatlogic-nginxNginx反向代理4.1.3 验证部署等待2-3分钟后检查服务状态# 查看应用日志 docker compose -f docker-compose.yml logs neatlogic-app # 检查服务健康状态 curl http://localhost:8080/health4.2 方案二传统部署方式4.2.1 源码编译打包进入项目目录使用Maven进行编译# 切换到项目根目录 cd neatlogic-itom-all # 编译项目首次编译需要下载依赖时间较长 mvn clean install -DskipTests # 编译成功后WAR包位置 ls neatlogic-webroot/target/neatlogic.war4.2.2 配置应用服务器Tomcat配置部署WAR包# 复制WAR包到Tomcat webapps目录 sudo cp neatlogic-webroot/target/neatlogic.war /opt/tomcat/webapps/ # 启动Tomcat sudo /opt/tomcat/bin/startup.sh配置数据库连接 编辑neatlogic-webroot/src/main/resources/config/application.properties# MySQL数据库配置 spring.datasource.urljdbc:mysql://localhost:3306/neatlogic?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai spring.datasource.usernameneatlogic spring.datasource.passwordYourStrongPassword123! spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver # MongoDB配置 spring.data.mongodb.urimongodb://localhost:27017/neatlogicNginx反向代理配置编辑Nginx配置文件/etc/nginx/nginx.confserver { listen 80; server_name your-domain.com; # 静态资源缓存 location /static/ { alias /opt/neatlogic/static/; expires 30d; access_log off; } # API反向代理 location / { proxy_pass http://localhost:8080; 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; # WebSocket支持 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; } # 客户端最大body大小 client_max_body_size 100M; }重启Nginx服务sudo nginx -t sudo systemctl restart nginx4.2.3 初始化数据库执行数据库初始化脚本# 进入数据库脚本目录 cd neatlogic-itom-all/sql # 导入基础数据 mysql -u neatlogic -p neatlogic init.sql # 导入示例数据可选 mysql -u neatlogic -p neatlogic demo_data.sql4.3 首次访问配置4.3.1 访问系统打开浏览器访问以下地址Docker部署http://localhost:80传统部署http://your-domain.com4.3.2 初始管理员账号首次登录使用默认管理员账号用户名admin密码admin123 安全提醒首次登录后请立即修改管理员密码4.3.3 系统初始化向导系统首次启动会自动进入初始化向导许可协议确认阅读并接受用户协议数据库配置验证数据库连接状态管理员设置修改默认管理员信息邮件服务器配置系统通知邮件完成初始化系统自动重启并进入主界面5. 配置调优与最佳实践5.1 性能优化配置5.1.1 JVM参数优化编辑Tomcat启动脚本/opt/tomcat/bin/setenv.sh# JVM内存配置 export JAVA_OPTS$JAVA_OPTS -Xms4g -Xmx8g -XX:MaxMetaspaceSize512m # GC优化 export JAVA_OPTS$JAVA_OPTS -XX:UseG1GC -XX:MaxGCPauseMillis200 export JAVA_OPTS$JAVA_OPTS -XX:ParallelGCThreads4 -XX:ConcGCThreads2 # 堆内存溢出时生成dump文件 export JAVA_OPTS$JAVA_OPTS -XX:HeapDumpOnOutOfMemoryError export JAVA_OPTS$JAVA_OPTS -XX:HeapDumpPath/opt/tomcat/logs/heapdump.hprof5.1.2 数据库连接池优化编辑config/application.properties# HikariCP连接池配置 spring.datasource.hikari.maximum-pool-size20 spring.datasource.hikari.minimum-idle10 spring.datasource.hikari.idle-timeout30000 spring.datasource.hikari.connection-timeout30000 spring.datasource.hikari.max-lifetime1800000 # MySQL性能优化 spring.datasource.hikari.connection-test-querySELECT 1 spring.datasource.hikari.pool-nameNeatLogicPool5.1.3 Redis缓存配置可选如果需要提升性能可以配置Redis缓存# Redis配置 spring.redis.hostlocalhost spring.redis.port6379 spring.redis.password spring.redis.database0 spring.redis.timeout3000ms spring.redis.lettuce.pool.max-active20 spring.redis.lettuce.pool.max-idle10 spring.redis.lettuce.pool.min-idle55.2 安全加固建议5.2.1 HTTPS配置配置Nginx支持HTTPSserver { listen 443 ssl http2; server_name your-domain.com; ssl_certificate /etc/nginx/ssl/your-domain.crt; ssl_certificate_key /etc/nginx/ssl/your-domain.key; # SSL安全配置 ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512; ssl_prefer_server_ciphers off; # HSTS头 add_header Strict-Transport-Security max-age63072000 always; location / { proxy_pass http://localhost:8080; # ... 其他代理配置 } }5.2.2 访问控制配置在config/application.properties中配置安全策略# 会话超时设置30分钟 server.servlet.session.timeout30m # CSRF防护启用 spring.security.csrf.enabledtrue # XSS防护头 server.servlet.session.cookie.http-onlytrue server.servlet.session.cookie.securetrue5.3 监控与日志配置5.3.1 日志级别配置编辑config/logback-spring.xml!-- 调整特定包日志级别 -- logger namecom.neatlogic levelINFO/ logger nameorg.springframework levelWARN/ logger nameorg.hibernate levelWARN/ !-- 输出到文件 -- appender nameFILE classch.qos.logback.core.rolling.RollingFileAppender filelogs/neatlogic.log/file rollingPolicy classch.qos.logback.core.rolling.TimeBasedRollingPolicy fileNamePatternlogs/neatlogic.%d{yyyy-MM-dd}.log/fileNamePattern maxHistory30/maxHistory totalSizeCap3GB/totalSizeCap /rollingPolicy encoder pattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n/pattern /encoder /appender5.3.2 健康检查端点NeatLogic内置健康检查接口# 检查应用健康状态 curl http://localhost:8080/actuator/health # 查看应用信息 curl http://localhost:8080/actuator/info # 查看运行指标 curl http://localhost:8080/actuator/metrics5.4 备份与恢复策略5.4.1 数据库备份脚本创建自动备份脚本/opt/backup/backup.sh#!/bin/bash BACKUP_DIR/opt/backup/data DATE$(date %Y%m%d_%H%M%S) # MySQL备份 mysqldump -u neatlogic -pYourPassword neatlogic $BACKUP_DIR/neatlogic_$DATE.sql gzip $BACKUP_DIR/neatlogic_$DATE.sql # MongoDB备份 mongodump --urimongodb://localhost:27017/neatlogic --out$BACKUP_DIR/mongodb_$DATE # 保留最近7天备份 find $BACKUP_DIR -name *.gz -mtime 7 -delete find $BACKUP_DIR -name mongodb_* -type d -mtime 7 -exec rm -rf {} \;5.4.2 配置定时备份# 编辑crontab crontab -e # 每天凌晨2点执行备份 0 2 * * * /opt/backup/backup.sh /var/log/neatlogic_backup.log 216. 故障排除与常见问题6.1 启动问题排查6.1.1 Tomcat启动失败如果Tomcat启动失败按以下步骤排查检查端口占用# 查看8080端口是否被占用 netstat -tlnp | grep 8080 # 如果被占用可以修改Tomcat端口 vi /opt/tomcat/conf/server.xml # 修改Connector port8080 ...为其他端口检查日志文件# 查看Tomcat启动日志 tail -f /opt/tomcat/logs/catalina.out # 查看应用日志 tail -f /opt/tomcat/logs/neatlogic.log常见错误及解决方案错误信息可能原因解决方案java.lang.OutOfMemoryErrorJVM内存不足增加JVM内存参数-Xmx4g -Xms2gjava.sql.SQLException数据库连接失败检查数据库服务状态和连接参数org.springframework.beans.factory.BeanCreationExceptionSpring Bean初始化失败检查配置文件中的Bean定义6.1.2 数据库连接问题如果遇到数据库连接错误检查以下配置# 测试MySQL连接 mysql -h localhost -u neatlogic -p -e SELECT 1 # 检查MySQL服务状态 systemctl status mysql # 查看MySQL错误日志 tail -f /var/log/mysql/error.log确保MySQL配置允许远程连接-- 修改MySQL用户权限 ALTER USER neatlogic% IDENTIFIED WITH mysql_native_password BY YourPassword; GRANT ALL PRIVILEGES ON neatlogic.* TO neatlogic%; FLUSH PRIVILEGES;6.2 性能问题优化6.2.1 响应缓慢排查如果系统响应缓慢使用以下工具进行诊断# 查看系统资源使用情况 top -c # 查看Java进程状态 jps -l jstat -gcutil pid 1000 10 # 生成线程转储 jstack pid thread_dump.txt # 生成堆转储 jmap -dump:live,formatb,fileheap_dump.hprof pid6.2.2 数据库性能优化优化MySQL配置/etc/mysql/my.cnf[mysqld] # 内存配置 innodb_buffer_pool_size 2G innodb_log_file_size 256M innodb_flush_log_at_trx_commit 2 # 连接配置 max_connections 200 wait_timeout 600 interactive_timeout 600 # 查询缓存MySQL 8.0已移除 # query_cache_size 0 # query_cache_type 06.3 常见问题FAQQ1: 如何重置管理员密码A: 如果忘记管理员密码可以通过数据库重置-- 进入MySQL mysql -u root -p neatlogic -- 重置admin用户密码 UPDATE t_user SET password MD5(newpassword123) WHERE user_id admin;Q2: 如何查看系统版本信息A: 通过以下方式查看系统版本Web界面登录系统后点击右上角用户头像 → 关于API接口访问http://your-domain.com/api/version数据库查询SELECT * FROM t_system_config WHERE config_key system.version;Q3: 如何扩展系统功能A: NeatLogic支持模块化扩展开发新模块的步骤创建模块目录mkdir neatlogic-custom-module mkdir neatlogic-custom-module-base配置pom.xmlparent groupIdcom.neatlogic/groupId artifactIdneatlogic-parent/artifactId version3.0.0-SNAPSHOT/version /parent实现基础接口Component public class CustomModuleInitializer implements IModuleInitializer { Override public void init() { // 模块初始化逻辑 } }Q4: 如何配置邮件通知A: 在系统管理 → 系统设置 → 邮件服务器配置# SMTP服务器配置 mail.hostsmtp.your-email.com mail.port587 mail.usernameyour-emailexample.com mail.passwordyour-password mail.protocolsmtp mail.smtp.authtrue mail.smtp.starttls.enabletrueQ5: 如何备份和迁移系统A: 完整的系统迁移流程数据库备份# 备份MySQL mysqldump -u neatlogic -p neatlogic backup.sql # 备份MongoDB mongodump --urimongodb://localhost:27017/neatlogic --outbackup_mongo配置文件备份# 备份应用配置 tar -czf config_backup.tar.gz config/ # 备份上传文件 tar -czf uploads_backup.tar.gz /opt/neatlogic/uploads/恢复步骤# 恢复MySQL mysql -u neatlogic -p neatlogic backup.sql # 恢复MongoDB mongorestore --urimongodb://localhost:27017/neatlogic backup_mongo/6.4 获取技术支持如果遇到无法解决的问题可以通过以下方式获取帮助查看官方文档项目根目录下的README文件检查日志文件logs/neatlogic.log社区支持访问项目GitCode页面提交Issue企业支持联系官方技术支持团队通过本文的详细指南你应该已经成功部署了NeatLogic ITOM平台。系统部署完成后建议按照以下步骤进行验证✅功能验证登录系统检查各模块功能是否正常✅性能测试模拟多用户并发访问检查系统响应时间✅数据验证创建测试数据验证数据存储和检索功能✅备份验证执行备份脚本验证备份文件完整性NeatLogic ITOM平台作为一款功能全面的开源IT运维管理解决方案能够帮助企业构建标准化、自动化的运维管理体系。无论是中小型企业还是大型组织都可以通过灵活的模块化配置打造适合自身需求的运维平台。【免费下载链接】neatlogic-itom-allNeatLogic is a progressive ITOM platform offering ITOM solutions for users of various types and sizes. It includes features like ITSM, CMDB, continuous integration, knowledge base, automation, reporting, and inspections. The platform is in active development, with upcoming additions of development and project management functionalities.项目地址: https://gitcode.com/gh_mirrors/ne/neatlogic-itom-all创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考