josh5/lancache-bundle

lancache-bundle

镜像概述和主要用途

lancache-bundle是一个基于https://github.com/lancachenet/%E9%A1%B9%E7%9B%AE%E7%9A%84%E6%8D%86%E7%BB%91%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8C%85%E5%90%AB%E4%BA%86%E5%AE%98%E6%96%B9%E6%95%B4%E4%BD%93%E5%A0%86%E6%A0%88%E7%9A%84%E6%89%80%E6%9C%89%E7%BB%84%E4%BB%B6%E3%80%82%E5%AE%83%E7%9B%B8%E5%BD%93%E4%BA%8E%E7%9B%B4%E6%8E%A5%E8%BF%90%E8%A1%8Clancachenet%E5%AE%98%E6%96%B9%E7%9A%84%E5%8D%95%E4%BD%93%E5%A0%86%E6%A0%88%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%B8%80%E7%AB%99%E5%BC%8F%E7%9A%84%E5%B1%80%E5%9F%9F%E7%BD%91%E7%BC%93%E5%AD%98%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%EF%BC%8C%E7%94%A8%E4%BA%8E%E7%BC%93%E5%AD%98%E7%BD%91%E7%BB%9C%E5%86%85%E5%AE%B9%EF%BC%88%E5%A6%82%E6%B8%B8%E6%88%8F%E6%9B%B4%E6%96%B0%E3%80%81%E8%BD%AF%E4%BB%B6%E4%B8%8B%E8%BD%BD%E7%AD%89%EF%BC%89%EF%BC%8C%E4%BB%8E%E8%80%8C%E6%8F%90%E5%8D%87%E4%B8%8B%E8%BD%BD%E9%80%9F%E5%BA%A6%E5%B9%B6%E6%98%BE%E8%91%97%E5%87%8F%E5%B0%91%E5%AF%B9%E5%A4%96%E5%B8%A6%E5%AE%BD%E6%B6%88%E8%80%97%E3%80%82

核心功能和特性

• 完整堆栈集成：包含lancachenet的所有核心组件，如monolithic缓存服务、lancache-dns域名解析服务、sniproxy代理服务和generic通用缓存服务
• 简化部署：通过单一镜像整合多组件，减少部署复杂度
• 智能缓存机制：采用LRU（最近最少使用）策略自动管理缓存空间
• 灵活配置：支持通过环境变量自定义IP地址、缓存路径、缓存大小等关键参数
• DNS解析优化：自动将缓存域名解析到本地缓存服务器，非缓存域名转发至上游DNS

使用场景和适用范围

• 局域网环境：适用于企业、学校、网吧等拥有多台设备的局域网
• 带宽密集型应用：优化游戏更新、软件下载、系统补丁等大流量内容的分发
• 网络优化：减少重复下载，提升多用户同时下载的速度和稳定性
• 节省带宽成本：降低对外网络带宽需求，尤其适合带宽有限或按流量计费的网络环境

使用方法和配置说明

前提条件

• Docker和Docker Compose已安装
• 足够的存储空间用于缓存（建议根据需求配置CACHE_DISK_SIZE）
• 缓存服务器需有固定IP地址

基本配置

通过.env文件或环境变量进行配置，核心参数如下：

必配参数

推荐配置参数

其他配置参数

部署示例

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'

services:
  lancache:
    image: lancachenet/monolithic
    env_file: .env
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - "${CACHE_ROOT}/cache:/data/cache"
      - "${CACHE_ROOT}/logs:/data/logs"
    restart: always

  dns:
    image: lancachenet/lancache-dns
    env_file: .env
    ports:
      - "53:53/udp"
    restart: always

  sniproxy:
    image: lancachenet/sniproxy
    ports:
      - "443:443"
    depends_on:
      - lancache
    restart: always

创建.env文件并配置必要参数：

env
LANCACHE_IP=192.168.0.100  # 替换为你的缓存服务器IP
DNS_BIND_IP=192.168.0.100  # 替换为你的缓存服务器IP
CACHE_ROOT=/path/to/lancache  # 替换为实际缓存目录
CACHE_DISK_SIZE=2000000m  # 2000GB缓存空间
UPSTREAM_DNS=114.114.114.114;8.8.8.8  # 上游DNS

启动服务：

bash
docker-compose up -d

网络配置

使局域网设备使用缓存服务的两种方式：

1. DHCP配置：在DHCP服务器中设置DNS_BIND_IP为首选DNS服务器，所有使用DHCP的设备将自动使用缓存服务
2. 现有DNS集成：通过https://github.com/uklans/cache-domains%E9%A1%B9%E7%9B%AE%E7%94%9F%E6%88%90%E9%85%8D%E7%BD%AE%E6%95%B0%E6%8D%AE%EF%BC%8C%E5%AF%BC%E5%85%A5%E5%88%B0%E7%8E%B0%E6%9C%89DNS%E5%9F%BA%E7%A1%80%E8%AE%BE%E6%96%BD

更多信息

• 缓存域名列表由https://github.com/uklans/cache-domains%E9%A1%B9%E7%9B%AE%E8%87%AA%E5%8A%A8%E7%94%9F%E6%88%90%E5%92%8C%E7%BB%B4%E6%8A%A4
• 常见问题解答：https://github.com/lancachenet/monolithic/blob/master/faq.md