griefed/app-collection

App-Collection 镜像文档

镜像概述

App-Collection 是一个应用程序集合，正如其名，它整合了多个之前单独发布的Docker容器应用到单个容器中。该镜像基于 lsiobase/nginx 构建，底层为Alpine Linux和S6 overlay，支持与主机使用相同的用户/组ID，简化文件传输。首次启动容器可能需要较长时间，因为应用在首次运行时安装（非镜像内置），尤其是Composerize可能需要几分钟完成安装。

核心功能和特性

当前包含的应用

主要特性

• 多架构支持：提供latest（amd64/x86_64）和arm（ARM架构，如树莓派3B）标签
• 自定义安装：通过环境变量控制是否安装特定应用
• 权限兼容：支持设置PUID/PGID，避免主机与容器间文件权限问题
• 灵活配置：支持HTTP/HTTPS协议，可自定义时区、域名等

使用场景

适用于需要整合多个工具类Web应用的用户，如开发者需要Composerize（转换docker run命令为docker-compose）、nginxconfig.io（生成NGINX配置）、active-forks（分析GitHub仓库活跃分支）等工具，通过单个容器简化部署和管理。

部署方法

标签说明

Docker Compose部署

yaml
version: "2"
services:
  app-collection:
    image: griefed/app-collection:latest
    container_name: app-collection
    restart: unless-stopped
    environment:
      - TZ=Europe/Berlin # 时区
      - PUID=1000 # 用户ID
      - PROTOCOL=https # 访问协议，HTTP或HTTPS
      - PGID=1000 # 组ID
      - INSTALL_TRIANGULATOR=true # 是否安装triangulator，true或false
      - INSTALL_TGEN=true # 是否安装tgen，true或false
      - INSTALL_NGINXCONFIG_IO=true # 是否安装NGINXConfig.io，true或false
      - INSTALL_DCC=true # 是否安装dcc，true或false
      - INSTALL_COMPOSERIZE=true # 是否安装composerize，true或false
      - INSTALL_ACTIVE_GITHUB_FORKS=true # 是否安装Active GitHub Forks，true或false
      - INSTALL_PHP_NOISE=true # 是否安装php-noise，true或false
      - DOMAIN=www.example.com # 容器访问地址（IP或域名）
    volumes:
      - /host/path/to/config:/config # 存储应用数据和配置文件
    ports:
      - 443:443 # HTTPS端口
      - 80:80 # HTTP端口

CLI部署

bash
docker create \
  --name=app-collection \
  -e TZ=Europe/Berlin \
  -e PUID=1000 \
  -e PROTOCOL=https \
  -e PGID=1000 \
  -e INSTALL_TRIANGULATOR=true \
  -e INSTALL_TGEN=true \
  -e INSTALL_NGINXCONFIG_IO=true \
  -e INSTALL_DCC=true \
  -e INSTALL_COMPOSERIZE=true \
  -e INSTALL_ACTIVE_GITHUB_FORKS=true \
  -e INSTALL_PHP_NOISE=true \
  -e DOMAIN=www.example.com \
  -v /host/path/to/config:/config \
  -p 443:443 \
  -p 80:80 \
  --restart unless-stopped \
  griefed/app-collection:latest

配置参数说明

环境变量

卷挂载

INSTALL变量与.lock文件

• 若INSTALL_*变量设为false，容器启动时不会安装对应应用；设为true则安装并在/config/www/生成appname.lock文件。
• 如需重新安装应用，删除对应appname.lock文件。
• 如需卸载应用：1. 停止容器；2. 将对应INSTALL_*设为false；3. 编辑apps.json移除对应条目（或删除卷目录生成新配置）；4. 重启容器。

用户/组ID

容器使用PUID/PGID确保卷目录权限与主机一致。通过id username命令获取主机用户的UID/GID，例如：

bash
$ id username
uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

自建镜像

1. 克隆仓库：git clone https://github.com/Griefed/docker-App-Collection.git ./docker-App-Collection
2. 编辑docker-compose.yml：

yaml
version: '3.6'
services:
  app-collection:
    build: ./docker-App-Collection/
    container_name: app-collection
    restart: unless-stopped
    environment:
      - TZ=Europe/Berlin
      - PUID=1000
      - PROTOCOL=https
      - PGID=1000
      - INSTALL_TRIANGULATOR=true
      - INSTALL_TGEN=true
      - INSTALL_NGINXCONFIG_IO=true
      - INSTALL_DCC=true
      - INSTALL_COMPOSERIZE=true
      - INSTALL_ACTIVE_GITHUB_FORKS=true
      - INSTALL_PHP_NOISE=true
      - DOMAIN=www.example.com
    volumes:
      - /host/path/to/config:/config
    ports:
      - 443:443
      - 80:80

3. 构建并启动：docker-compose up -d --build app-collection

应用详情

Active GitHub Forks

• 需提供GitHub个人令牌以提高API查询限额（仅存储在本地浏览器）
• 显示原始仓库（加粗）及分支差异，可配置最大分支数量和缓存策略（基于大小或最后推送时间）
• 支持查看分支提交差异，点击“Diff”列查看详细提交

Composerize

• 功能：将docker run命令转换为docker-compose.yml配置
• 注意：包含原作者添加的广告，与本镜像无关；可通过编辑/config/www/composerize/static/js/runtime-main.c7d51d1a.js（约162行）移除广告，编辑/config/www/composerize/index.html移除Google Analytics

dcc Web

• 修改了原项目的index.html和CSS，使其可在常规Apache服务器（如httpd:alpine容器）中部署

NGINXConfig.io

• 生成针对特定场景的优化NGINX配置，支持多种功能和指令，可实时预览配置效果并参考NGINX文档

SUI Dashboard Status

• 支持主题颜色切换（点击左下角“Options”按钮）
• 自定义应用：编辑apps.json添加应用，格式示例：

  json
  {
    "apps": [
      {"name":"应用1","hostname":"sub1.example.com","port":80,"href":"https://sub1.example.com","icon":"icon-name"}
    ]
  }
  

• 自定义书签：编辑links.json添加书签，格式示例：

  json
  {
    "bookmarks": [
      {
        "category":"分类1",
        "links": [{"name":"链接1","url":"http://example.com"}]
      }
    ]
  }
  

• 图标名称参考Material Design Icons

tgen

• 纹理生成工具，支持通过JavaScript API创建自定义纹理，示例：

  javascript
  var generator = tgen.init(256, 256);
  var canvas = generator.do('fill').do('waves', {blend: 'difference'}).toCanvas();
  

triangulator

• 图像三角化工具，可将图片转换为三角网格风格图像

php-noise

• PHP噪声生成工具，用于创建各种噪声纹理