\u7cfb\u7edf\u4fe1\u606f\u9a8c\u8bc1\u793a\u4f8b：<\/p>\n
cat<\/span> \/etc\/os-release # Debian GNU\/Linux 12 (bookworm)<\/span> \u4e0b\u8f7d\u5b98\u65b9 Raspberry Pi OS (64-bit) Bookworm Lite（\u63a8\u8350 Lite \u7248，\u8282\u7701\u8d44\u6e90）：<\/p>\n https:\/\/www.raspberrypi.com\/software\/<\/p>\n 2025-11-24-raspios-bookworm-arm64-lite.img.xz<\/p>\n<\/li>\n \u4f7f\u7528 Raspberry Pi Imager \u70e7\u5f55：<\/p>\n \u5199\u5165：\u56e0\u4e3a\u4f7f\u7528\u7684\u7cfb\u7edf\u662fwin7，\u6545\u5199\u5165\u4f7f\u7528\u6811\u8393\u6d3e\u955c\u50cf\u70e7\u5f55\u5668V1.7.5 \u56e0\u4e3a\u70e7\u5f55\u524d\u5df2\u7ecf\u914d\u7f6e\u4e86\u8fde\u63a5wifi，ssh\u8bbf\u95ee\u4f7f\u80fd\u7b49\u3002\u63d2\u5165SD\u5361，\u542f\u52a8\u6811\u8393\u6d3e\u8fde\u63a5\u663e\u793a\u5668\u5373\u53ef\u770b\u5230WIFI\u7684ip，\u4f7f\u7528SSH\u8fde\u63a5\u3002\u4e5f\u53ef\u4ee5\u4f7f\u7528ip\u626b\u63cf\u5de5\u5177\u626b\u63cf\u83b7\u53d6\u3002<\/p>\n \u626b\u63cfIP:<\/p>\n SSH\u8fde\u63a5，<\/p>\n sudo<\/span> apt<\/span> update &&<\/span> sudo<\/span> apt<\/span> full-upgrade -y sudo<\/span> swapoff -a &&<\/span> sudo<\/span> rm<\/span> -f \/swapfile sudo<\/span> systemctl enable<\/span> fstrim.timer<\/p>\n curl<\/span> -fsSL https:\/\/deb.nodesource.com\/setup_18.x |<\/span> sudo<\/span> -E bash<\/span> – \u786e\u4fdd\u4f60\u7684\u7cfb\u7edf\u5df2\u5b89\u88c5（\u524d\u9762\u5df2\u7ecf\u5b89\u88c5）：<\/p>\n \u68c0\u67e5\u5b89\u88c5：<\/p>\n docker<\/span> –version #\u8f93\u51fa\u5982\u4e0b：<\/span> \u914d\u7f6e\u56fd\u5185\u6e90：<\/p>\n # \u914d\u7f6e\u56fd\u5185 Docker \u955c\u50cf\u52a0\u901f（\u5f3a\u70c8\u63a8\u8350，\u52a0\u901f\u62c9\u53d6）<\/span> \u91cd\u542f Docker \u670d\u52a1（\u5fc5\u987b\u64cd\u4f5c，\u5426\u5219 daemon.json \u4e0d\u751f\u6548）：<\/p>\n sudo<\/span> systemctl restart docker<\/span><\/p>\n \u68c0\u67e5\u955c\u50cf\u52a0\u901f\u662f\u5426\u751f\u6548：<\/p>\n docker<\/span> info |<\/span> grep<\/span> -A 10<\/span> "Registry Mirrors"<\/span> \u63a8\u8350\u4f7f\u7528 docker-compose（\u4fbf\u4e8e\u7ba1\u7406\u3001\u5065\u5eb7\u68c0\u67e5\u3001\u6570\u636e\u6301\u4e45\u5316）：<\/p>\n \u521b\u5efa docker-compose.yml：<\/p>\n # \u521b\u5efa docker-compose.yml \u6587\u4ef6<\/span> \u542f\u52a8：<\/p>\n mkdir<\/span> -p ~\/mongodb_data sudo<\/span> apt<\/span> install<\/span> -y redis-server sudo<\/span> cp<\/span> \/etc\/redis\/redis.conf \/etc\/redis\/redis.conf.backup<\/p>\n sudo<\/span> tee<\/span> \/etc\/redis\/redis.conf <<<\/span>EOF sudo<\/span> mkdir<\/span> -p \/var\/log\/redis &&<\/span> sudo<\/span> chown<\/span> redis:redis \/var\/log\/redis sudo<\/span> npm<\/span> install<\/span> -g genieacs@1.2.13 sudo<\/span> useradd<\/span> -r -s \/bin\/false genieacs GENIEACS_UI_JWT_SECRET<\/span>=<\/span>$(<\/span>openssl rand -hex 32<\/span>)<\/span><\/span> sudo<\/span> chown<\/span> genieacs:genieacs \/opt\/genieacs\/genieacs.env sudo tee \/etc\/systemd\/system\/genieacs-cwmp.service << 'EOF' [Service] [Install] sudo<\/span> tee<\/span> \/etc\/systemd\/system\/genieacs-fs.service <<<\/span> 'EOF' [Service] [Install] sudo<\/span>
\nuname<\/span> -m # aarch64<\/span><\/p>\n1. \u7cfb\u7edf\u51c6\u5907<\/h4>\n
1.1\u4e0b\u8f7d\u5e76\u5237\u5199\u955c\u50cf：<\/h5>\n
\n
\n
\n
\n![\"\u5728\u8fd9\u91cc\u63d2\u5165\u56fe\u7247\u63cf\u8ff0\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/01\/20260131080511-697db7b7c7458.png\")
<\/p>\n![\"\u5728\u8fd9\u91cc\u63d2\u5165\u56fe\u7247\u63cf\u8ff0\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/01\/20260131080511-697db7b7e4c7a.png\")
<\/p>\n1.2 SSH\u8fde\u63a5<\/h5>\n
![\"\u5728\u8fd9\u91cc\u63d2\u5165\u56fe\u7247\u63cf\u8ff0\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/01\/20260131080512-697db7b80d482.png\")
<\/p>\n![\"\u5728\u8fd9\u91cc\u63d2\u5165\u56fe\u7247\u63cf\u8ff0\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/01\/20260131080512-697db7b827df4.png\")
<\/p>\n1.3\u66f4\u65b0\u7cfb\u7edf\u4e0e\u57fa\u7840\u5de5\u5177<\/h5>\n
\nsudo<\/span> apt<\/span> install<\/span> -y curl<\/span> htop<\/span> iotop logrotate<\/span> ufw nano<\/span> vim<\/span> git<\/span> docker.io docker-compose<\/span>
\nsudo<\/span> usermod<\/span> -aG docker<\/span> $USER<\/span> # \u9700\u91cd\u65b0\u767b\u5f55\u751f\u6548<\/span>
\nsudo<\/span> reboot<\/span><\/p>\n2. \u914d\u7f6e\u4ea4\u6362\u7a7a\u95f4（\u5f3a\u70c8\u63a8\u8350 1GB）<\/h4>\n
\nsudo<\/span> fallocate -l 1G \/swapfile
\nsudo<\/span> chmod<\/span> 600<\/span> \/swapfile
\nsudo<\/span> mkswap<\/span> \/swapfile
\nsudo<\/span> swapon<\/span> \/swapfile
\necho<\/span> '\/swapfile none swap sw 0 0'<\/span> |<\/span> sudo<\/span> tee<\/span> -a \/etc\/fstab
\nsudo<\/span> swapon<\/span> –show &&<\/span> free<\/span> -h
\n#\u663e\u793a\u5982\u4e0b<\/span>
\nNAME TYPE SIZE USED PRIO
\n\/swapfile file<\/span> 1024M 0B -2
\n total used free<\/span> shared buff\/cache available
\nMem: 906Mi 167Mi 591Mi 3<\/span>.3Mi 200Mi 739Mi
\nSwap: 1<\/span>.0Gi 0B 1<\/span>.0Gi<\/p>\n3. \u5b58\u50a8\u4f18\u5316（\u5fc5\u987b）<\/h4>\n
\n
4. \u5b89\u88c5 Node.js 18.x LTS（GenieACS \u63a8\u8350）<\/h4>\n
\nsudo<\/span> apt<\/span> install<\/span> -y nodejs
\nnode<\/span> -v # \u5e94\u663e\u793a v18.x v18.20.8<\/span>
\nnpm<\/span> -v # \u5e94\u663e\u793a ~10.x 10.8.2<\/span><\/p>\n5. \u5b89\u88c5 MongoDB（Docker + 4.4.18，\u552f\u4e00\u7a33\u5b9a\u65b9\u6848）<\/h4>\n
\n
\ndocker-compose<\/span> –version<\/p>\n
\nDocker version 20.10<\/span>.24+dfsg1, build 297e128
\ndocker-compose<\/span> version 1.29<\/span>.2, build unknown<\/p>\n
\nsudo<\/span> mkdir<\/span> -p \/etc\/docker
\nsudo<\/span> tee<\/span> \/etc\/docker\/daemon.json <<<\/span>EOF
\n{
\n "registry-mirrors": [
\n "https:\/\/docker.m.daocloud.io",
\n "https:\/\/mirror.ccs.tencentyun.com",
\n "https:\/\/registry.docker-cn.com"
\n ]
\n}
\nEOF<\/span><\/p>\n
\n#\u8f93\u51fa<\/span>
\nWARNING: No memory limit support
\nWARNING: No swap limit support
\n Registry Mirrors:
\n https:\/\/docker.m.daocloud.io\/
\n https:\/\/mirror.ccs.tencentyun.com\/
\n https:\/\/registry.docker-cn.com\/
\n Live Restore Enabled: false<\/span><\/p>\n
\ncat<\/span> ><\/span> docker-compose.yml <<<\/span> 'EOF'
\nversion: '3.8'
\nservices:
\n mongodb:
\n image: mongo:4.4.18
\n container_name: mongodb
\n restart: unless-stopped
\n ports:
\n – "27017:27017"
\n volumes:
\n – .\/mongodb_data:\/data\/db
\n command: mongod –wiredTigerCacheSizeGB 0.25 # \u9650\u5236\u5185\u5b58\u4f7f\u7528
\n healthcheck:
\n test: ["CMD", "mongo", "–eval", "db.adminCommand({ping:1})"]
\n interval: 10s
\n timeout: 5s
\n retries: 5
\nEOF<\/span><\/p>\n
\ndocker-compose<\/span> up -d
\ndocker<\/span> ps<\/span> |<\/span> grep<\/span> mongodb
\ndocker<\/span> exec<\/span> -it mongodb mongo –eval "db.adminCommand({ping:1})"<\/span> # \u5e94\u8fd4\u56de { "ok" : 1 }<\/span>
\n#\u8fd4\u56de\u4fe1\u606f<\/span>
\nconnecting to: mongodb:\/\/127.0.0.1:27017\/?compressors=<\/span>disabled&<\/span>gssapiServiceName<\/span>=<\/span>mongodb
\nImplicit session: session {<\/span> "id"<\/span> :<\/span> UUID(<\/span>"ea92330d-4093-4268-b4d0-ef82e80a8463"<\/span>)<\/span> }<\/span>
\nMongoDB server version: 4.4<\/span>.18
\n{<\/span> "ok"<\/span> :<\/span> 1<\/span> }<\/span><\/p>\n6. \u5b89\u88c5\u5e76\u4f18\u5316 Redis（128MB \u5185\u5b58\u9650\u5236）<\/h4>\n
\nsudo<\/span> systemctl enable<\/span> –now redis-server<\/p>\n
\nbind 127.0.0.1
\nport 6379
\ndaemonize yes
\nsupervised systemd
\nmaxmemory 128mb
\nmaxmemory-policy allkeys-lru
\nsave ""
\nappendonly no
\ntcp-keepalive 60
\ntimeout 0
\nmaxclients 100
\nloglevel notice
\nlogfile \/var\/log\/redis\/redis.log
\nEOF<\/span><\/p>\n
\nsudo<\/span> systemctl restart redis-server
\nredis-cli ping<\/span> # \u5e94\u8fd4\u56de PONG<\/span>
\nredis-cli info memory |<\/span> grep<\/span> used_memory_human<\/p>\n7. \u5b89\u88c5 GenieACS（\u56fa\u5b9a\u7248\u672c 1.2.13，\u907f\u514d\u6700\u65b0\u7248\u4e0d\u7a33\u5b9a）<\/h4>\n
\nnpm<\/span> list -g |<\/span> grep<\/span> genieacs
\nwhich<\/span> genieacs-cwmp genieacs-fs genieacs-nbi genieacs-ui
\n#\u8f93\u51fa<\/span>
\n\/usr\/bin\/genieacs-cwmp
\n\/usr\/bin\/genieacs-fs
\n\/usr\/bin\/genieacs-nbi
\n\/usr\/bin\/genieacs-ui<\/p>\n8. \u521b\u5efa\u4e13\u7528\u7528\u6237\u4e0e\u76ee\u5f55<\/h4>\n
\nsudo<\/span> mkdir<\/span> -p \/opt\/genieacs\/{<\/span>config,logs,uploads,backups}<\/span>
\nsudo<\/span> chown<\/span> -R genieacs:genieacs \/opt\/genieacs
\nsudo<\/span> chmod<\/span> 750<\/span> \/opt\/genieacs\/config
\nsudo<\/span> chmod<\/span> 755<\/span> \/opt\/genieacs\/{<\/span>logs,uploads,backups}<\/span>
\n# \u9a8c\u8bc1\u76ee\u5f55\u7ed3\u6784<\/span>
\nls<\/span> -la \/opt\/genieacs\/
\n#\u8f93\u51fa<\/span>
\ntotal 24<\/span>
\ndrwxr-xr-x 6<\/span> genieacs genieacs 4096<\/span> Jan 28<\/span> 12<\/span>:14 .<\/span>
\ndrwxr-xr-x 4<\/span> root root 4096<\/span> Jan 28<\/span> 12<\/span>:14 ..<\/span>
\ndrwxr-xr-x 2<\/span> genieacs genieacs 4096<\/span> Jan 28<\/span> 12<\/span>:14 backups
\ndrwxr-x— 2<\/span> genieacs genieacs 4096<\/span> Jan 28<\/span> 12<\/span>:14 config
\ndrwxr-xr-x 2<\/span> genieacs genieacs 4096<\/span> Jan 28<\/span> 12<\/span>:14 logs
\ndrwxr-xr-x 2<\/span> genieacs genieacs 4096<\/span> Jan 28<\/span> 12<\/span>:14 uploads<\/p>\n9. \u73af\u5883\u53d8\u91cf\u6587\u4ef6（\/opt\/genieacs\/genieacs.env）<\/h4>\n
\nsudo<\/span> tee<\/span> \/opt\/genieacs\/genieacs.env <<<\/span>EOF
\nMONGODB_CONNECTION_URL=mongodb:\/\/127.0.0.1:27017\/genieacs
\nREDIS_URL=redis:\/\/127.0.0.1:6379\/0
\nCWMP_PORT=7547
\nFS_PORT=7567
\nNBI_PORT=7557
\nUI_PORT=3000
\nGENIEACS_UI_JWT_SECRET=$GENIEACS_UI_JWT_SECRET<\/span>
\nDEBUG=genieacs:*
\nCWMP_WORKER_PROCESSES=1 # \u9650\u5236\u5e76\u53d1，\u9002\u5408 Pi 3B+
\nEOF<\/span><\/p>\n
\nsudo<\/span> chmod<\/span> 600<\/span> \/opt\/genieacs\/genieacs.env<\/p>\n10. Systemd \u670d\u52a1\u6587\u4ef6<\/h4>\n
10.1 genieacs-cwmp.service （\u6838\u5fc3 CWMP \u670d\u52a1）<\/h5>\n
\n[Unit]
\nDescription=GenieACS CWMP Server
\nAfter=network.target docker.service redis-server.service
\nRequires=docker.service redis-server.service<\/p>\n
\nType=simple
\nUser=genieacs
\nGroup=genieacs
\nEnvironmentFile=\/opt\/genieacs\/genieacs.env
\nWorkingDirectory=\/opt\/genieacs
\nExecStart=\/usr\/bin\/genieacs-cwmp
\nRestart=on-failure
\nRestartSec=10
\nMemoryMax=300M
\nMemorySwapMax=500M
\nCPUQuota=80%<\/p>\n
\nWantedBy=multi-user.target
\nEOF<\/p>\n10.2 genieacs-fs.service （\u6587\u4ef6\u670d\u52a1）<\/h5>\n
\n[Unit]
\nDescription=GenieACS FS Server
\nAfter=network.target docker.service redis-server.service
\nRequires=docker.service redis-server.service<\/p>\n
\nType=simple
\nUser=genieacs
\nGroup=genieacs
\nEnvironmentFile=\/opt\/genieacs\/genieacs.env
\nWorkingDirectory=\/opt\/genieacs
\nExecStart=\/usr\/bin\/genieacs-fs
\nRestart=on-failure
\nRestartSec=10
\nMemoryMax=250M
\nMemorySwapMax=400M
\nCPUQuota=60%<\/p>\n
\nWantedBy=multi-user.target
\nEOF<\/span><\/p>\n10.3 genieacs-nbi.service （\u5317\u5411\u63a5\u53e3\u670d\u52a1）<\/h5>\n