tearsful/gecoosac repository overview

⁠🚀 集客 AC Docker 版（gecoosac）

⁠🆕 新增 UI 镜像（标签 ui）

我们新增了一个 DIY 定制 AC 管理 UI 镜像，标签为 ui（docker pull tearsful/gecoosac:ui）。

• DIY 定制界面：独立 Vue 控制台 + 无内置 Web 的 AC 核心，适合 iframe 嵌入、深度集成与品牌定制（非集客官方内置页面）。
• 留言板：管理界面底部 留言板⁠ 入口，方便收集使用反馈与建议。

⁠📋 更新记录

2026-10

• ‼️ 补全一些界面选项中文化：AP 状态/自定义射频筛选、接入点加密与频段、模板频道自动等

• ‼️ 优化AP升级逻辑

  • 一. 本地升级：选择本地固件、点「确定」后，会上传并立即升级，固件同时存入历史固件，不再需要切到历史固件页再选一次。如果服务器上已有同名固件，会弹出两个选项：
    • a:「覆盖并升级」：用本次上传的文件覆盖后升级。
    • b:「使用已有固件升级」：直接用已存的那份升级。
  • 二. 在线升级：地址栏可以填两种地址：
    • 具体的.bin链接：和以前一样直接升级。
    • 目录或页面地址：后端新增了一个检索接口 apfirmware_probe，抓取页面里所有.bin链接（相对路径和中文目录都能正确解析），再按所选 AP 的型号分组匹配

2026-09

• ‼️ 修复停用AC后仍显示运行中 / AC 在线

• ‼️ 强化AP的网口扩展VLAN功能的逻辑，会分多次使用默认密码、AC下发更新的密码从AP获取实际的扩展支持情况来动态展示AP的扩展VLAN功能。

• ‼️ 修复在线用户采样

• ‼️ AP升级优化，分在线升级、历史固件、本地升级、与实体 AC 一致

• ‼️ 「无线AP」升级优化，被选中参与升级的AP有多种型号时会导致与升级固件型号不一致，将弹出提示并提供选项供用户调整AP进行升级。除AP250MD和AP250MDV 按「同平台 + V=VLAN」处理混用升级外，其他型号一律不支持混用固件升级。

2026-08

• ‼️ 「在线用户」、仪表盘用户数、黑白名单等用户去重，避免计数和列表出现幽灵会话
• ‼️ 接入点信道列补齐干扰程度显示、模板管理和无线 AP 单机编辑功能增加射频自定义功能
• ‼️ 列表排序优化、固件随时上传、同型号替换、可删除、接入点页 AP/MAC、型号·IP 展示、在线用户 / 智能磁吸展示与多选

2026-07

• ‼️ 随时可上传本地包（不再因目录已有固件而禁用上传)

2026-06

• ‼️ gecoosac:ui优化前端「在线用户」、「智能磁吸」、接入点页面展示，提升AP辨别、确认率

• ‼️ gecoosac:ui前端无线AP页面添加显示AP的IP地址（v4/v6)以及AP内存占用显示！

• ‼️ 仅允许一个登陆会话在线！在线会话最长30分钟无操作退出到登陆界面！

• Docker Hub 新增标签 ui：DIY 定制 AC 管理 UI；内置 留言板⁠ 反馈入口

• 定制端：概览 / 无线 AP / 模板 / 分组 / 在线用户 / 智能磁吸 / 黑白名单等；10 分钟无操作自动重新登录

此前（V2 / latest）

• V2 同步官方 20251015；自定义 webport；智能磁吸；WIFI 加密增强
• 2025-07-17：禁用日志存储，避免空间占用

⁠ℹ️ 其他说明

• V2：接口端（60650）与管理 Web（8080 / webport）分离。
• ui：管理 Web 为 DIY 定制界面；AP 升级临时目录 /tmp，重启后不保留上传文件。

快速启动示例：

docker pull tearsful/gecoosac:ui

docker run -d --name jike-ac-ui \
  --network=host \
  --restart unless-stopped \
  -v jike-ac-data:/data \
  -v jike-ac-tmp:/tmp \
  -e webport=8080 \
  -e passwd=你的管理密码 \
  tearsful/gecoosac:ui

访问：http://<IP>:8080/（密码由 passwd 指定，默认 admin）。

⁠✨ 镜像标签一览

⁠📝 快速开始（V2 · latest / v2）

⁠1️⃣ 访问管理页面

• V2 默认：http://<IP>:8080
• V2 自定义：-e webport=80 → http://<IP>:80
• V1：http://<IP>:60650

⁠2️⃣ 端口说明

⁠⚙️ 环境变量

⁠💾 数据持久化

-v /your/local/dir:/data

⁠🐳 Docker 启动示例（V2 · latest）

⁠群晖 / 通用

docker run \
  --network=host \
  --privileged \
  -v /your/local/dir:/data \
  -e UID=0 -e GID=0 -e GIDLIST=0 \
  -e passwd=123456 \
  --restart always \
  --name AC \
  -d tearsful/gecoosac:latest

⁠自定义 Web 管理端口

docker run \
  --network=host \
  --privileged \
  -v /your/local/dir:/data \
  -e UID=0 -e GID=0 -e GIDLIST=0 \
  -e passwd=123456 \
  -e webport=80 \
  --restart always \
  --name AC \
  -d tearsful/gecoosac:latest

⁠🛠️ MikroTik 容器安装（V2 示例）

1. 添加 veth 接口
   /interface/veth/add name=AC address=172.16.1.2/24 gateway=172.16.1.1
/interface/bridge/port add bridge=bridge interface=AC
2. 环境变量
   /container/envs/add name=ac_env key=passwd value="123456"
/container/envs/add name=ac_env key=webport value="80"
3. 挂载数据
   /container/mounts/add name=ac_mounts src=/ac/data dst=/data
4. 拉取运行
   /container/config/set registry-url=https://registry-1.docker.io tmpdir=/container
/container/add remote-image=tearsful/gecoosac interface=AC mounts=ac_mounts envlist=ac_env

使用 DIY UI 时请将镜像改为 tearsful/gecoosac:ui。