permissionbrick/lancache-bundle

permissionbrick/lancache-bundle镜像说明

镜像概述

本镜像基于https://github.com/lancachenet/%E9%A1%B9%E7%9B%AE%E7%9A%84%E5%AE%98%E6%96%B9monolithic stack构建，是一个集成式的lancache服务包。它在原有功能基础上增加了自定义DNS条目配置能力，可有效防止DNS查询泄漏到根服务器，适用于局域网环境部署缓存服务器。

核心功能

1. 完整缓存服务栈：包含lancache-dns、sniproxy、generic等组件，提供一站式缓存解决方案；
2. 自定义DNS配置：支持添加最多9条自定义DNS条目（通过环境变量设置）；
3. DNS泄漏防护：避免非缓存域名查询直接流向根服务器；
4. 智能缓存管理：基于磁盘大小和缓存时间自动清理旧数据（LRU策略）。

使用场景

• 局域网内游戏、软件等大文件下载加速；
• 企业/校园网络减少外部带宽消耗；
• 提升多用户并发下载的稳定性。

配置说明

必选环境变量

• LANCACHE_IP：缓存服务的IP地址（如192.168.1.100）；
• DNS_BIND_IP：DNS服务监听的IP地址（需与LANCACHE_IP一致或为本地IP）；

可选环境变量

• 自定义DNS条目：
  • CUSTOM_DNS_NAME_1~9：自定义域名（如example.com）；
  • CUSTOM_DNS_HOST_1~9：对应域名的IPv4地址；
  • CUSTOM_DNS_HOST_1~9_V6：对应域名的IPv6地址（可选）；
• 缓存配置：
  • UPSTREAM_DNS：上游DNS服务器（默认8.8.8.8）；
  • CACHE_ROOT：缓存数据存储根目录（默认./lancache）；
  • CACHE_DISK_SIZE：缓存最大磁盘空间（如1000000m，单位为MB）；
  • CACHE_MAX_AGE：缓存数据最大保留时间（如3650d，单位为天）。

部署示例（docker-compose.yml）

yaml
version: '3'
services:
  lancache:
    image: permissionbrick/lancache-bundle
    container_name: lancache-bundle
    environment:
      - LANCACHE_IP=192.168.1.100
      - DNS_BIND_IP=192.168.1.100
      - UPSTREAM_DNS=1.1.1.1
      - CACHE_ROOT=/opt/lancache
      - CACHE_DISK_SIZE=2000000m
      - CUSTOM_DNS_NAME_1=internal.game.com
      - CUSTOM_DNS_HOST_1=192.168.1.200
    ports:
      - "53:53/udp"  # DNS服务端口
      - "80:80"       # HTTP缓存端口
      - "443:443"     # HTTPS缓存端口
    volumes:
      - /opt/lancache:/lancache  # 映射缓存目录
    restart: always

更多信息

• 缓存域名列表来自https://github.com/uklans/cache-domains%EF%BC%9B
• 官方FAQ：https://github.com/lancachenet/monolithic/blob/master/faq.md%E3%80%82