当前位置：首页 > news >正文

如何快速部署GenieACS？5分钟上手TR-069 ACS服务器搭建

news 2026/7/27 16:33:13

如何快速部署GenieACS？5分钟上手TR-069 ACS服务器搭建

【免费下载链接】genieacsA fast and lightweight TR-069 Auto Configuration Server (ACS)项目地址: https://gitcode.com/gh_mirrors/ge/genieacs

GenieACS是一款轻量级TR-069自动配置服务器（ACS），专为高效管理网络设备设计。本文将带您通过简单步骤，在5分钟内完成GenieACS的部署，让您快速掌握这款强大工具的安装与基础配置。

📋 部署前准备：检查环境要求

在开始部署前，请确保您的系统满足以下条件：

核心依赖项

Node.js：需要12.13及以上版本，用于运行GenieACS的JavaScript代码
MongoDB：需要3.6及以上版本，用于存储设备管理数据

这些依赖项可通过官方网站获取安装包，或使用系统包管理器快速安装。

⚡ 两种安装方式：选择最适合您的方案

方法1：通过NPM快速安装（推荐新手）

NPM是Node.js的包管理器，提供最简单的安装途径：

sudo npm install -g genieacs

这条命令会从NPM仓库下载并全局安装最新版本的GenieACS，适合大多数用户快速上手。

方法2：从源码安装（适合开发者）

如果您需要自定义或参与开发，可以从源码安装：

git clone https://gitcode.com/gh_mirrors/ge/genieacs cd genieacs npm install npm run build

源码安装需要额外的构建步骤，但能获得最新特性。详细编译指南可参考项目根目录下的README.md。

🔧 基础配置：3步完成系统设置

第1步：创建系统用户与目录

为确保安全，建议创建专用系统用户运行GenieACS服务：

sudo useradd --system --no-create-home --user-group genieacs mkdir /opt/genieacs /opt/genieacs/ext chown genieacs:genieacs /opt/genieacs/ext

第2步：配置环境变量

创建环境配置文件/opt/genieacs/genieacs.env，设置关键参数：

# 日志文件配置 GENIEACS_CWMP_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-cwmp-access.log GENIEACS_NBI_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-nbi-access.log GENIEACS_FS_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-fs-access.log GENIEACS_UI_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-ui-access.log GENIEACS_DEBUG_FILE=/var/log/genieacs/genieacs-debug.yaml # 扩展目录设置 GENIEACS_EXT_DIR=/opt/genieacs/ext

生成安全的JWT密钥并添加到配置文件：

node -e "console.log(\"GENIEACS_UI_JWT_SECRET=\" + require('crypto').randomBytes(128).toString('hex'))" >> /opt/genieacs/genieacs.env

设置文件权限：

sudo chown genieacs:genieacs /opt/genieacs/genieacs.env sudo chmod 600 /opt/genieacs/genieacs.env

第3步：创建日志目录与日志轮转

mkdir /var/log/genieacs chown genieacs:genieacs /var/log/genieacs

创建日志轮转配置文件/etc/logrotate.d/genieacs：

/var/log/genieacs/*.log /var/log/genieacs/*.yaml { daily rotate 30 compress delaycompress dateext }

🚀 服务管理：启动与验证GenieACS

创建systemd服务单元

GenieACS包含四个核心服务，需要分别创建systemd配置：

CWMP服务（端口7547）：设备通信核心服务
NBI服务（端口7557）：北向API接口
FS服务（端口7567）：文件服务器
UI服务（端口3000）：Web管理界面

以CWMP服务为例，创建服务文件：

sudo systemctl edit --force --full genieacs-cwmp

粘贴以下内容：

[Unit] Description=GenieACS CWMP After=network.target [Service] User=genieacs EnvironmentFile=/opt/genieacs/genieacs.env ExecStart=/usr/bin/genieacs-cwmp [Install] WantedBy=default.target

对NBI、FS和UI服务执行相同操作，只需修改服务名称和描述。

启动并验证服务

# 启用并启动所有服务 sudo systemctl enable --now genieacs-cwmp genieacs-nbi genieacs-fs genieacs-ui # 检查服务状态 sudo systemctl status genieacs-cwmp genieacs-nbi genieacs-fs genieacs-ui

如果所有服务显示"active (running)"，说明部署成功！