myfunnystudy / luci-in-docker

LuCI running in docker, use for manager config files for other containers.

LuCI in Docker

• 在使用 Docker 的过程中，很多容器的配置文件需要管理，使用过程中不少人对命令行及配置文件不熟悉，所以考虑将 luci 装入容器，配合 luci-lib-docker 以进行 Docker 容器的配置文件管理
• luci-in-docker 将 openwrt 中 ubus 去除，宿主为 alpine，方便后期增加插件
• luci-in-docker 目的是将家用 NAS 服务全部部署在 Docker 中，并通过 luci 进行管理，从而实现 NAS IN DOCKER

运行容器

docker pull lisaac/luci
docker run -d \
  --name luci \
  --restart unless-stopped \
  --privileged \
  -p 80:80 \
  -e TZ=Asia/Shanghai \
  -v $HOME/pods/luci:/external:rslave \
  -v /media:/media:rshared \
  -v /dev:/dev:rslave \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --tmpfs /tmp:exec \
  --tmpfs /run \
  lisaac/luci

插件

• 插件合并时不会执行按照 Makefile 编译，所以需要编译完成后 ipk 中的 data 目录中的内容，或者纯 lua 源码 + 二进制文件
• 插件中 po 目录下的翻译文件会自动转换成对应 lmo，并合并至 luci/i18n 目录
• 插件中依赖文件 depends.lst 为 alpine 依赖，并非 openwrt 中的依赖
• 插件中的 preinst及 postinst 是在遍历插件目录执行的，可能执行 preinst 及 postinst 存在依赖其他插件的情况，可以将插件目录开头的加上数字，来确定遍历顺序
• 插件目录名若以 _ 开头，则会跳过此插件

目录结构

/
  |- external         # 外部目录，需要外部挂载
    |-cfg.d
      |-config        # UCI cofnig 目录，用于存放配置文件，启动后挂载至/etc/config
    |-plugin          # 插件目录
      |-luci-app-diskman    # 插件，会忽略以 _ 开头的目录，方便调试，插件结构如下：
        |-root        # 插件所需的 root 目录，合并至/tmp/.luci/
        |-luasrc      # 插件所需的 lua 文件目录，合并至/tmp/.luci/usr/lib/lua/luci
        |-htdoc       # 插件所需的 html 文件目录，合并至/tmp/.luci/www
        |-po          # 插件所需的 po 文件目录
        |-depends.lst # 插件所需要 alpine 依赖列表文件, 依赖用' '隔开, 只用来存放 alpine 依赖
        |-preinst     # 插件所需的初始化脚本(合并前)
        |-postinst    # 插件所需的初始化脚本(合并后)
      |-...
  |- internal         # 内部 luci-in-docker 自带插件目录(用户无需关心)
    |-plugin          # 内部插件目录
      |-luci          # luci 目录
        |-root        # 插件所需的 root 目录，合并至/tmp/.luci/
        |-luasrc      # 插件所需的 lua 文件目录，合并至/tmp/.luci/usr/lib/lua/luci
        |-htdoc       # 插件所需的 html 文件目录，合并至/tmp/.luci/www
        |-po          # 插件所需的 po 文件目录
        |-depends.lst # 插件所需要 alpine 依赖列表文件, 依赖用' '隔开, 只用来存放 alpine 依赖
        |-preinst     # 插件所需的初始化脚本(合并前)
        |-postinst    # 插件所需的初始化脚本(合并后)
      |-...
  |tmp
    |-.luci           # 合并后的 luci root 目录

• 通过遍历 internal/external 目录下 plugin 中的各个插件目录，将其合并至 /temp/.luci 目录中，并修改 path 环境变量
• 同时保证兼容性和持久性 config 目录存储位置为 external/cfg.d/config, 挂载至 /etc/config
• 遍历时先执行preinst，插件目录合并到 /temp/.luci 后，会通过 apk add 方式安装插件目录下 depends.lst 中需要的依赖，最后执行插件目录下 postinst

luci-app-diskman

创建容器的时候，已经通过-v $HOME/pods/luci:/external 将$HOME/pods/luci映射到容器中/external,安装插件需要2步：

• 插件放置到 $HOME/pods/luci/plugin/ (对应于容器中的/external/plugin)
• 重启 luci 容器:

mkdir -p $HOME/pods/luci/plugin
#拉取插件
git clone https://github.com/lisaac/luci-app-diskman $HOME/pods/luci/plugin/luci-app-diskman
#重启容器
docker restart luci 

tips: 由于 luci-app-diskman 中的依赖较多，第一次启动安装依赖可能会比较慢，需要多等一会，通过 docker logs luci 可以看到运行日志

luci-app-dockerman

git clone https://github.com/lisaac/luci-lib-docker $HOME/pods/luci/plugin/luci-lib-docker
git clone https://github.com/lisaac/luci-app-dockerman $HOME/pods/luci/plugin/luci-app-dockerman
docker restart luci

luci-plugin-samba

git clone http://github.com/lisaac/luci-plugin-samba $HOME/pods/luci/plugin/luci-lib-docker
docker restart luci

谢致

• openwrt/luci
• openwrt/openwrt