xavierh/goaccess-for-nginxproxymanager

GoAccess for Nginx Proxy Manager Logs

仍在开发中... 若日志量较大，解析可能需要一定时间。

支持解析的日志类型：

• Nginx Proxy Manager (NPM)
• NPM 重定向日志
• NPM 错误日志
• Traefik 日志
• Caddy 日志
• 自定义配置解析其他日志

!GoAccess 仪表盘

依赖项：

• GoAccess 版本：1.9.4
• GeoLite2-City.mmdb（2025-04-10）
• GeoLite2-Country.mmdb（2025-04-10）
• GeoLite2-ASN.mmdb（2025-04-10）

---

Docker 信息

• 镜像地址：https://hub.docker.com/r/xavierh/goaccess-for-nginxproxymanager
• 支持架构：
  • linux/amd64
  • linux/arm/v7
  • linux/arm64/v8
• ARM 版本：Just5KY 提供的 https://hub.docker.com/r/justsky/goaccess-for-nginxproxymanager
• 标签：https://hub.docker.com/r/xavierh/goaccess-for-nginxproxymanager/tags
  • 稳定版：xavierh/goaccess-for-nginxproxymanager:latest
  • 最新开发稳定版：xavierh/goaccess-for-nginxproxymanager:develop

GitHub 仓库

• https://github.com/xavier-hernandez/goaccess-for-nginxproxymanager

---

Docker 部署示例

基本配置

yml
version: '3.3'
services:
    goaccess:
        image: 'xavierh/goaccess-for-nginxproxymanager:latest'
        container_name: goaccess
        restart: always
        ports:
            - '7880:7880'
        environment:
            - TZ=America/New_York         
            - SKIP_ARCHIVED_LOGS=False # 可选
            - DEBUG=False # 可选
            - BASIC_AUTH=False # 可选
            - BASIC_AUTH_USERNAME=user # 可选
            - BASIC_AUTH_PASSWORD=pass # 可选   
            - EXCLUDE_IPS=127.0.0.1 # 可选，逗号分隔
            - LOG_TYPE=NPM # 可选，详见下文
            - ENABLE_BROWSERS_LIST=True # 可选，详见下文
            - CUSTOM_BROWSERS=Kuma:Uptime,TestBrowser:Crawler # 可选，逗号分隔，详见下文
            - HTML_REFRESH=5 # 可选，HTML报告刷新间隔（秒）。https://goaccess.io/man
            - KEEP_LAST=30 # 可选，保留最近指定天数的日志数据。https://goaccess.io/man
            - PROCESSING_THREADS=1 # 可选，并发处理线程数，影响日志分析速度，通常根据CPU核心数调整，默认1。https://goaccess.io/man
        volumes:
        - /path/to/host/nginx/logs:/opt/log
        - /path/to/host/custom:/opt/custom # 可选，使用LOG_TYPE=CUSTOM时必需

权限配置（解决权限问题）

若存在权限问题，可添加PUID和PGID，指定有权限读取日志文件的用户ID：

yml
version: '3.3'
services:
    goaccess:
        image: 'xavierh/goaccess-for-nginxproxymanager:latest'
        container_name: goaccess
        restart: always
        ports:
            - '7880:7880'
        environment:
            - PUID=0
            - PGID=0
            - TZ=America/New_York         
            - SKIP_ARCHIVED_LOGS=False # 可选
            - DEBUG=False # 可选
            - BASIC_AUTH=False # 可选
            - BASIC_AUTH_USERNAME=user # 可选
            - BASIC_AUTH_PASSWORD=pass # 可选   
            - EXCLUDE_IPS=127.0.0.1 # 可选，逗号分隔 
            - LOG_TYPE=NPM # 可选，详见下文
            - ENABLE_BROWSERS_LIST=True # 可选，详见下文
            - CUSTOM_BROWSERS=Kuma:Uptime,TestBrowser:Crawler # 可选，逗号分隔，详见下文
            - HTML_REFRESH=5 # 可选，HTML报告刷新间隔（秒）
            - KEEP_LAST=30 # 可选，保留最近指定天数的日志数据
            - PROCESSING_THREADS=1 # 可选，并发处理线程数，默认1
        volumes:
        - /path/to/host/nginx/logs:/opt/log
        - /path/to/host/custom:/opt/custom # 可选，使用LOG_TYPE=CUSTOM时必需

环境变量参数说明

其他环境信息

LOG_TYPE 参数说明

• CUSTOM

  • 加载自定义配置，需添加卷挂载/path/to/host/custom:/opt/custom，卷中必须包含goaccess.conf（自定义配置文件，端口需保持7890，无此文件容器将退出）。
  • 以下环境参数无效：SKIP_ARCHIVED_LOGS、EXCLUDE_IPS。

• NPM（默认）

  • 解析日志文件：proxy-host-_access.log.gz、proxy-host-_access.log、proxyhost-.log。

• NPM+R

  • 创建第二个GoAccess实例，通过URL路径/redirection访问（如http://localhost:7880/redirection/）。
  • 解析日志文件：redirectionhost-.log*.gz、redirectionhost-.log、fallback_access.log*.gz、fallback_access.log、dead-host*.log*.gz、dead-host*.log。

• NPM+ALL

  • 创建第二和第三个GoAccess实例：
    • /redirection：解析重定向日志（同NPM+R）；
    • /error：解析错误日志（_error.log.gz、*_error.log）。错误日志格式可能不一致，仅处理包含正确格式日志的文件，容器日志会显示跳过的文件。

• TRAEFIK

  • 解析日志文件：access.log及LOG_TYPE_FILE_PATTERN指定的*.log文件。
  • 以下环境参数无效：SKIP_ARCHIVED_LOGS。
  • 可自定义环境变量覆盖默认值：TIME_FORMAT、DATE_FORMAT、LOG_FORMAT。

• NCSA_COMBINED

  • 解析符合NCSA组合日志格式的文件，依赖LOG_TYPE_FILE_PATTERN指定文件。

• CADDY_V1

  • 解析Caddy v1日志，默认解析access.log，依赖LOG_TYPE_FILE_PATTERN指定文件。
  • 以下环境参数无效：SKIP_ARCHIVED_LOGS。

日志格式配置

NPM 代理日志格式

time-format %T
date-format %d/%b/%Y
log_format [%d:%t %^] %^ %^ %s - %m %^ %v "%U" [Client %h] [Length %b] [Gzip %^] [Sent-to %^] "%u" "%R"

NPM 重定向日志格式

time-format %T
date-format %d/%b/%Y
log_format [%d:%t %^] %s - %m %^ %v "%U" [Client %h] [Length %b] [Gzip %^] "%u" "%R"

NPM 错误日志格式

time-format %T
date-format %Y/%m/%d
log_format %d %t %^: %v, %^: %h, %^ %v %^"%r" %^

Traefik 访问日志格式

time-format %T
date-format %d/%b/%Y
log-format %h %^[%d:%t %^] "%r" %s %b "%R" "%u" %Lm"

Nginx 访问日志格式

time-format %T
date-format %d/%b/%Y
log-format %h %^[%d:%t %^] "%r" %s %b "%R" "%u"

Caddy 日志格式

time-format %s
date-format %s
date-spec min
log-format CADDY

可能的已知问题

• 高CPU使用率及WebUI每秒*次请求**

  • 参考：https://github.com/xavier-hernandez/goaccess-for-nginxproxymanager/issues/38

• 使用NPM代理容器时需启用WebSocket支持

  • 参考：https://github.com/xavier-hernandez/goaccess-for-nginxproxymanager/issues/69

• LOG_TYPE=NPM+ALL 错误日志解析问题

  • 错误日志格式可能不一致，仅处理包含正确格式日志的文件，容器日志会显示跳过的文件。

• DEBUG=True 模式

  • 应用版本（GOAN vX）不会显示在左侧工具栏，调试模式下不包含过多自定义内容。

致谢

感谢https://github.com/GregYankovoy%E6%8F%90%E4%BE%9B%E7%81%B5%E6%84%9F%E5%8F%8Anginx.conf%E9%85%8D%E7%BD%AE%E3%80%82
感谢用户：Just5KY、martadinata666。

免责声明

本产品包含MaxMind创建的GeoLite2数据，可从[***]