Docker Compose 本地环境搭建：kkFileView

[🔗 前言：Docker Compose 本地环境搭建相关文章](#🔗 前言：Docker Compose 本地环境搭建相关文章)
[🐳 Docker Compose 本地环境搭建：kkFileView](#🐳 Docker Compose 本地环境搭建：kkFileView)
- [📚 目录结构设计](#📚 目录结构设计)
- [📄 docker-compose.yml](#📄 docker-compose.yml)
- [🚀 启动方式](#🚀 启动方式)
- [🌐 浏览器访问](#🌐 浏览器访问)

🔗 前言：Docker Compose 本地环境搭建相关文章

🐳 Docker Compose 本地环境搭建：kkFileView

📚 目录结构设计

推荐使用如下结构：

bash 复制代码

infra/
├── .env

├── mysql/
│   └── docker-compose.yml

├── redis/
│   └── docker-compose.yml

├── elasticsearch/
│   └── docker-compose.yml

├── skywalking/
│   └── docker-compose.yml

├── nacos/
│   └── docker-compose.yml

📄 docker-compose.yml

bash 复制代码

# =========================================================
# 用于构建环境：kkFileView
# 宿主机挂载目录、端口、版本号、环境后缀均通过 .env 文件管理
# =========================================================

###########################################################
# 网络配置 (复用或独立创建指定子网)
###########################################################
networks:
  env_network: # 内部网络标识固定
    driver: bridge
    name: ${NETWORK_NAME}         # Docker 实际网络名动态生成
    ipam:
      config:
        - subnet: ${NETWORK_SUBNET}  # 子网从 .env 获取

###########################################################
# 卷（Volume）配置
###########################################################
volumes:
  # kkFileView 基础数据与缓存目录
  kkfileview_data:
    driver: local
    driver_opts:
      type: none
      device: ${HOST_VOLUME}/${ENV}/kkFileView/data
      o: bind
  # kkFileView 自定义字体目录（存放微软雅黑、宋体等）
  kkfileview_fonts:
    driver: local
    driver_opts:
      type: none
      device: ${HOST_VOLUME}/${ENV}/kkFileView/fonts
      o: bind

###########################################################
# 服务定义
###########################################################
services:
  # kkFileView
  kkfileview:
    image: keking/kkfileview:${KKFILEVIEW_VERSION}
    container_name: kkfileview_${KKFILEVIEW_VERSION}_${ENV}  # 容器名体现版本和环境
    networks:
      - env_network  # 内部网络引用固定标识
    ports:
      - "${KKFILEVIEW_PORT}:8012"
    volumes:
      - kkfileview_data:/opt/kkFileView/data
      - kkfileview_fonts:/usr/share/fonts
    restart: unless-stopped
    labels:
      env: ${ENV}
      version: ${KKFILEVIEW_VERSION}
      service: kkfileview_${ENV}

🚀 启动方式

在 .env 同级目录下执行

bash 复制代码

docker compose --env-file .env -f kkfileview/docker-compose.yml up -d

-d 表示后台运行
Compose 会：
- 自动读取 .env 文件里的变量
- 根据 docker-compose.yml 配置创建网络、卷和容器
- 容器名、端口、挂载目录都会根据 .env 替换

🌐 浏览器访问

bash 复制代码

http://localhost:28012