Synology DS120j（aarch64）Docker安装及Home Assistant部署求助

一、修正Docker基础配置 #

1. 验证Docker用户组关联

   • 执行groups命令，查看输出是否包含docker组；若未显示，重新执行以下命令：

     sudo groupadd docker
     sudo usermod -aG docker $USER
     

   • 注销当前SSH连接后重新登录，再次执行groups确认组权限已生效。

2. 配置Docker数据目录（daemon.json）
   该配置用于将Docker镜像、容器数据迁移到自定义目录（避免占用系统盘空间），操作步骤：

   • 创建目标目录（建议用DSM共享目录，方便后续管理）：

     sudo mkdir -p /volume1/docker
     

   • 创建并编辑daemon.json文件：

     sudo nano /etc/docker/daemon.json
     

   • 粘贴以下JSON格式内容（注意语法正确）：

     {
       "data-root": "/volume1/docker"
     }
     

   • 按Ctrl+O保存，Ctrl+X退出编辑器
   • 重启Docker服务使配置生效：

     sudo systemctl restart docker
     

   • 验证配置：执行docker info | grep "Docker Root Dir"，输出应显示你设置的目录路径。

二、安装Portainer（替代Docker GUI管理） #

Portainer是轻量型Docker可视化管理工具，适合无GUI环境，执行以下命令启动：

docker run -d -p 9000:9000 \
--name portainer \
--restart=always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /volume1/docker/portainer_data:/data \
portainer/portainer-ce:latest

• 命令说明：
  • -d：后台运行容器
  • -p 9000:9000：映射NAS的9000端口到容器端口，访问地址为http://你的NAS IP:9000
  • --restart=always：NAS重启后自动启动Portainer
  • -v /var/run/docker.sock:/var/run/docker.sock：授予Portainer控制本地Docker的权限
  • -v /volume1/docker/portainer_data:/data：保存Portainer配置数据到自定义目录
• 访问设置：打开浏览器输入上述地址，设置管理员密码后选择「Local」环境，即可进入可视化管理界面。

三、无GUI安装Home Assistant（aarch64适配） #

DS120j为aarch64架构，需拉取对应版本的Home Assistant镜像，推荐使用轻量的Container版本：

1. 创建Home Assistant数据目录并设置权限：

   sudo mkdir -p /volume1/docker/homeassistant
   sudo chown -R 1000:1000 /volume1/docker/homeassistant
   

   • chown命令用于将目录权限适配容器内的Home Assistant用户（UID/GID均为1000），避免权限冲突。

2. 启动Home Assistant容器：

   docker run -d \
   --name homeassistant \
   --privileged \
   --restart=always \
   -v /volume1/docker/homeassistant:/config \
   -v /etc/localtime:/etc/localtime:ro \
   -v /run/dbus:/run/dbus:ro \
   -p 8123:8123 \
   ghcr.io/home-assistant/home-assistant:stable
   

   • 命令说明：
     • --privileged：授予容器足够权限，支持后续访问蓝牙、Zigbee等硬件适配器
     • -v /etc/localtime:/etc/localtime:ro：同步NAS时区到容器
     • -v /run/dbus:/run/dbus:ro：允许Home Assistant访问系统DBus服务，用于设备发现
     • -p 8123:8123：映射8123端口，访问地址为http://你的NAS IP:8123
   • 首次启动需等待5-10分钟（镜像下载+初始化），之后即可进入Home Assistant配置界面。

四、额外注意事项 #

• 若之前通过脚本安装过Docker，建议先清理残留：sudo apt-get purge docker-ce docker-ce-cli containerd.io，再按上述步骤重新配置，避免冲突。
• DSM 7.1.4权限管控严格，所有挂载目录建议放在/volume1下的共享目录中，避免系统根目录的自定义目录权限被DSM重置。
• 后续添加Zigbee/蓝牙适配器时，需在启动命令中增加设备映射，例如--device=/dev/ttyUSB0:/dev/ttyUSB0（根据实际设备路径调整）。

内容的提问来源于stack exchange，提问作者Mamie Mames McCall