Docker-⭐DPanel(可视化管理面板)

轻量化的 Docker 可视化管理面板，提供完善的容器管理功能
docker run 可以直接管理，使用其它方式部署的 docker-compose 需要挂载本地项目目录

**相关链接：**
- DPanel：https://dpanel.cc/#/
- Doc：https://dpanel.cc/#/README
  - docker-compose 挂载本地：https://dpanel.cc/#/zh-cn/manual/compose/create
  - 远程管理docker客户端：https://dpanel.cc/#/zh-cn/manual/system/remote
  - 应用商店：https://dpanel.cc/#/zh-cn/manual/setting/store
  - Nginx配置：https://dpanel.cc/#/zh-cn/install/nginx-location
- GitHub：https://github.com/donknap/dpanel
- Docker：https://hub.docker.com/r/dpanel/dpanel

**镜像细分为两个版本：**
- latest(标准版)：提供了域名绑定及Https证书功能，需要绑定80及443端口(实测没找到配置入口)
- ⭐lite：不包含域名转发功能，即容器内不会安装 nginx 及 acme.sh 等相关组件(自己外部部署即可)

## [Docker 部署](https://dpanel.cc/#/zh-cn/install/docker)
```bash
# 快速部署
docker run -it -d --name dpanel --restart=always -p 8080:8080 -v ${PWD}:/dpane -v /var/run/docker.sock:/var/run/docker.sock -v dpanel:/dpanel dpanel/dpanel:lite
```

## [docker-compose 部署](https://dpanel.cc/#/zh-cn/install/compose)
```bash
mkdir dpanel  # 创建数据目录
nano docker-compose.yml
docker-compose up -d  # 拉取并部署
```
`docker-compose.yml`，注意挂载本地Compose项目需内部路径同宿主机路径
远程Docker的本地Compose项目也是需要如此操作(先把远程文件挂载到宿主机再挂至容器内)
```yaml
services:
  dpanel:  # DPanel 主服务
    # image: dpanel/dpanel:lite  # 使用lite版,Nginx和SSL自行部署
    image: registry.cn-hangzhou.aliyuncs.com/dpanel/dpanel:lite  # 阿里云镜像
    # image: ccr.ccs.tencentyun.com/dpanel/dpanel:lite  # 腾讯云镜像
    container_name: dpanel  # 容器名称,不可禁用(必须和 APP_NAME 一致)
    restart: unless-stopped  # 非停止状态则自动重启
    # ports:
    #   - 28080:8080  # 面板访问端口
    # environment:
    #   APP_NAME: dpanel  # 面板内部会根据名称获取容器信息(必须和 container_name 一致,默认为 dpanel)
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 连接 docker 套接字
      - ./dpanel:/dpanel # dpanel 数据目录
      # - /volume1/docker:/volume1/docker  # 挂载本地Compose项目文件夹(内部需和外部一样,可管理本地Compose项目)
      #                                    # 若是远程Docker需要管理本地创建的Compose项目,需要把远程项目也挂载到容器内
    networks:
      - nginxui_default  # 连接网络名称(也可仅把需要反向代理的额外加入nginx)
  dpanel-plugin-explorer:  # dpanel 文件浏览器,单独部署是为了隔离特权
    image: alpine:latest  # 使用 alpine 作为基础镜像
    container_name: dpanel-plugin-explorer  # 容器名称
    restart: unless-stopped  # 未停止时自动重启
    privileged: true  # 开启特权模式,用于访问宿主机文件系统
    pid: host  # 设置模式为 host,用于访问宿主机文件系统
    command: ["sh", "-c", "tail -f /dev/null"]  # 启动命令
    # networks:
    #   - nginxui_default  # 连接网络名称(也可仅把需要反向代理的额外加入nginx)

# # 加入nginx容器所在网络(否则无法使用nginx代理)
# networks:  # 该项和 services 同级(顶格)
#   nginxui_default:  # 连接网络名称
#     external: true  # 加入网络
#     name: nginxui_default  # 网络的名称
```
对于远程Docker项目路径和本地项目路径一致的，挂载本地Compose项目至容器内后，远程Docker也会显示该本地Compose项目也可编辑，但实际编辑的还是本机宿主机的

## [Nginx 配置](https://dpanel.cc/#/zh-cn/install/nginx-location)
```bash
server {
  listen 80;  # 监听端口
  server_name _;  # 监听所有域名
  # DPanel(可视化管理面板)
  location / {  # 匹配所有请求(⭐推荐)
    proxy_set_header X-Real-IP $remote_addr;  # 获取客户端真实IP地址
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  # 获取客户端原始请求地址
    proxy_set_header Host $http_host;  # 获取请求的Host信息
    proxy_set_header X-NginX-Proxy true;  # 标记这是一个Nginx代理的请求
    proxy_set_header Upgrade $http_upgrade;  # 处理WebSocket等升级协议
    proxy_set_header Connection "upgrade";  # 处理持久连接
    proxy_cache_bypass $http_upgrade;  # 支持WebSocket等升级协议
    proxy_pass http://dpanel:8080/;   # 后端服务器地址(使用内部容器连接)
  }
  # DPanel(可视化管理面板)
  location /dpanel/ {  # 子路径匹配(会有一些问题,不推荐)
    proxy_set_header X-Real-IP $remote_addr;  # 获取客户端真实IP地址
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  # 获取客户端原始请求地址
    proxy_set_header Host $http_host;  # 获取请求的Host信息
    proxy_set_header X-NginX-Proxy true;  # 标记这是一个Nginx代理的请求
    proxy_set_header Upgrade $http_upgrade;  # 处理WebSocket等升级协议
    proxy_set_header Connection "upgrade";  # 处理持久连接
    proxy_cache_bypass $http_upgrade;  # 支持WebSocket等升级协议
    proxy_pass http://dpanel:8080/;   # 后端服务器地址(使用内部容器连接)
    proxy_redirect off;  # 关闭代理的重定向功能
    # 使用sub_filter模块对返回内容进行替换
    sub_filter '/api' '/dpanel/api';  # 替换api路径
    sub_filter '/ws' '/dpanel/ws';  # 替换ws路径
    sub_filter '/dpanel' '/dpanel/dpanel';  # 替换dpanel路径
    sub_filter_types text/html text/javascript;  # 处理html和js文件
    sub_filter_once off;  # 只对每个响应内容做一次替换
  }
}
```

## [挂载本地 docker-compose 项目](https://dpanel.cc/#/zh-cn/manual/compose/create?id=%e9%80%9a%e8%bf%87%e6%8c%82%e8%bd%bd%e5%ad%98%e5%82%a8%e8%b7%af%e5%be%84%e7%9a%84%e6%96%b9%e5%bc%8f%e5%88%9b%e5%bb%ba)

## [连接远程Docker](https://dpanel.cc/#/zh-cn/manual/system/remote)
1. 配置 [Docker-API(远程连接)](/doc/1010/)，`使用 https方式`
2. 下载好证书文件 `ca.pem,cert.pem,key.pem`
3. DPanel 连接远程Dcoker
`DPanel——系统——多客户端`
名称，标识(后期不可改)，随意
Docker Api 地址，`tcp://<远程Docker域名/IP>:<端口>`
启用TLS，然后把从远程端下载的证书文件一一上传
4. DPanel 右上的 `切换Docker客户端` 中就可以切换了

### [开启独立 Compose 目录](https://dpanel.cc/#/zh-cn/manual/setting/docker-env?id=%e5%bc%80%e5%90%af%e7%8b%ac%e7%ab%8b-compose-%e7%9b%ae%e5%bd%95)
默认 多docker客户端 是共享 compose任务数据(创建的compose任务可以多个docker使用)
面板支持 任意远程docker客户端 配置 独立Compose目录，用于数据的隔离
只需要在连接 `远程客户端` 时勾选 `启用独立Compose目录`
目录(启用独立Compose)为 `/dpanel/compose-环境标识`，全局目录(未启用独立Compose)为 `/dpanel/compose`

## [DPanel 控制命令](https://dpanel.cc/#/zh-cn/install/ctrl)
```bash
docker exec -it dpanel /bin/sh  # 进入 DPanel容器
  /app/server/dpanel -f /app/server/config.yaml user:reset --password 123456  # 重置管理员密码
  /app/server/dpanel -f /app/server/config.yaml user:reset --password 123456 --username root  # 重置用户名
  /app/server/dpanel -f /app/server/config.yaml store:sync --name storename  # 更新应用商店数据
```