lancachenet/lancache-dns

Lancache DNS Docker容器

!https://img.shields.io/docker/pulls/lancachenet/monolithic?label=Monolithic !https://img.shields.io/docker/pulls/lancachenet/lancache-dns?label=Lancache-dns !https://img.shields.io/docker/pulls/lancachenet/sniproxy?label=Sniproxy !https://img.shields.io/docker/pulls/lancachenet/generic?label=Generic

镜像概述和主要用途

Lancache DNS Docker容器是Lancache.net项目的重要组件，提供DNS服务功能，专为Steam缓存（steamcache）等场景设计。作为DNS解析服务，其核心用途是将局域网内游戏内容（如Steam平台）的域名请求定向至本地Lancache缓存服务器，实现游戏内容的本地缓存与访问，减少重复的外部网络请求，提升局域网内多用户同时下载的效率，降低出口带宽占用。

核心功能和特性

核心功能

• 定向DNS解析：将Steam等游戏平台的内容域名解析至本地Lancache缓存服务器，而非直接请求外部网络。
• 上游DNS兼容：支持配置上游DNS服务器，确保非缓存域名的正常解析。
• 轻量级部署：基于Docker容器化设计，资源占用低，部署与维护简单。
• 生态集成：与Lancache项目的其他组件（如monolithic缓存服务、sniproxy代理服务）无缝配合，构建完整的局域网缓存解决方案。

使用场景和适用范围

适用场景

• 局域网Steam游戏缓存：在企业、学校、家庭等局域网环境中，为多用户提供Steam游戏内容的本地缓存，减少重复下载，提升下载速度。
• 带宽优化：适用于出口带宽有限的网络环境，通过本地缓存减轻外部网络负载，降低流量成本。
• 多平台扩展：虽主要针对Steam，亦可通过配置支持其他基于HTTP/HTTPS的游戏平台或内容分发网络（需配合Lancache其他组件）。

适用范围

• 局域网环境（企业内网、校园网、家庭网络等）。
• 需要部署Lancache缓存服务的场景，作为缓存系统的DNS解析核心组件。

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）及Docker Compose（如需使用compose配置）。
• 已部署Lancache缓存服务器（如lancachenet/monolithic），并获取其局域网IP地址（下文简称LANCACHE_IP）。

Docker Run命令示例

通过docker run快速启动Lancache DNS服务：

bash
docker run -d \
  --name lancache-dns \
  --restart always \
  -p 53:53/udp \
  -p 53:53/tcp \
  -e UPSTREAM_DNS="8.8.8.8,8.8.4.4" \  # 上游DNS服务器，默认使用Google DNS
  -e LANCACHE_IP="192.168.1.100" \      # 本地Lancache缓存服务器IP（必填）
  -e TZ="Asia/Shanghai" \               # 时区配置（可选，默认UTC）
  lancachenet/lancache-dns:latest

Docker Compose配置示例

创建docker-compose.yml文件，定义服务组合（推荐用于多组件协同部署）：

yaml
version: '3'

services:
  lancache-dns:
    image: lancachenet/lancache-dns:latest
    container_name: lancache-dns
    restart: always
    ports:
      - "53:53/udp"   # DNS服务UDP端口（必填）
      - "53:53/tcp"   # DNS服务TCP端口（必填，支持DNS over TCP）
    environment:
      - UPSTREAM_DNS="114.114.114.114,119.29.29.29"  # 配置国内上游DNS（如114DNS）
      - LANCACHE_IP="192.168.1.100"                  # 本地Lancache缓存服务器IP（必填）
      - TZ="Asia/Shanghai"                           # 时区
    networks:
      - lancache-network  # 建议与Lancache缓存服务处于同一自定义网络

networks:
  lancache-network:
    driver: bridge

启动服务：docker-compose up -d

配置参数说明

文档与支持

Lancache.net项目的完整文档可在官方网站查看。
本lancache-dns容器的具体文档参见官方文档页面。
如阅读文档后仍有问题，请先参考支持页面，再在GitHub提交新issue。

许可证

MIT许可证（MIT）

版权所有（c）2015-2017 Jessica Smith, Robin Lewis, Brian Wojtczak, Jason Rivers, James Kinsman

特此授予任何获得本软件及相关文档文件（“软件”）副本的人免费许可，允许其无限制地处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利，以及允许向其提供软件的人做出上述行为，但须满足以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何明示或暗示的担保，包括但不限于对适销性、特定用途适用性和非侵权性的担保。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易引起的任何索赔、损害或其他责任承担责任，无论是合同诉讼、侵权行为还是其他形式的诉讼。