Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
donknap committed Nov 28, 2024
1 parent 13486d4 commit 33158c8
Show file tree
Hide file tree
Showing 2 changed files with 21 additions and 27 deletions.
2 changes: 1 addition & 1 deletion docs/zh-cn/install/compose.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 通过 compose 方式创建

!> 阿里云镜像 \
?> 阿里云加速镜像地址 \
registry.cn-hangzhou.aliyuncs.com/dpanel/dpanel:latest \
registry.cn-hangzhou.aliyuncs.com/dpanel/dpanel:lite

Expand Down
46 changes: 20 additions & 26 deletions docs/zh-cn/install/docker.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,20 @@
# 使用 Docker 安装

!> 阿里云镜像 \
!> DPanel 面板为了隔离权限,在使用文件管理功能时需要使用 dpanel-plugin-explorer 容器。此插件容器并不暴露任何端口,你也可以随时删除。\
此插件容器使用 alpine 镜像,你也可以手动创建,名称保持为 dpanel-plugin-explorer 即可。\
如果你没有手动创建,面板会自动创建。如果你无法接受,请勿使用【文件管理】功能!!!!

?> 阿里云加速镜像地址 \
registry.cn-hangzhou.aliyuncs.com/dpanel/dpanel:latest \
registry.cn-hangzhou.aliyuncs.com/dpanel/dpanel:lite


#### 创建容器


!> DPanel 面板为了隔离权限,在使用文件管理功能时需要使用 dpanel-plugin-explorer 容器。此插件容器并不暴露任何端口,你也可以随时删除。\
此插件容器使用 alpine 镜像,你也可以手动创建,名称保持为 dpanel-plugin-explorer 即可。\
如果你没有手动创建,面板会自动创建。如果你无法接受,请勿使用【文件管理】功能!!!!
#### 安装标准版

> macos 下需要先将 docker.sock 文件 link 到 /var/run/docker.sock 目录中 \
> ln -s -f /Users/用户/.docker/run/docker.sock /var/run/docker.sock
创建面板容器时,请根据实际情况修改映射端口。面板不能绑定 host 网络(请勿指定 --network host !!!)
> ln -s -f /Users/用户/.docker/run/docker.sock /var/run/docker.sock \
创建面板容器时,请根据实际情况修改映射端口。面板不能绑定 host 网络<span style="color: red">(请勿使用 --network host 参数!!!)</span> \
默认版本中提供了域名绑定及Https证书功能,需要绑定 80 及 443 端口。如果你不需要这些功能,请安装 Lite 版

```
Expand All @@ -26,7 +24,7 @@ docker run -it -d --name dpanel --restart=always \
-v dpanel:/dpanel -e APP_NAME=dpanel dpanel/dpanel:latest
```

##### 安装 Lite 版
#### 安装 Lite 版

在 lite 版中,不包含域名转发功能。即容器内不会安装 nginx 及 acme.sh 等相关组件

Expand All @@ -41,7 +39,7 @@ docker run -it -d --name dpanel --restart=always \
-v dpanel:/dpanel dpanel/dpanel:lite
```

##### 自定义宿主机目录存储
#### 自定义宿主机目录存储

面板会产生一些数据存储至容器内的 /dpanel 目录中,默认下此目录会挂载到 docker 的存储卷中

Expand All @@ -59,16 +57,16 @@ docker run -it -d --name dpanel --restart=always \
```


##### 配置面板管理员用户名密码
#### 配置面板管理员用户名密码

创建完成面板容器后,首次进入需要先配置管理员用户和密码。如果你忘记密码可以使用 [重置用户名密码](/zh-cn/install/ctrl?id=重置管理员用户)


##### 通过 tcp 连接 docker
#### 通过 tcp 管理 docker

面板请求 docker 服务时需要绑定宿主机的 /var/run/docker.sock 文件
创建面板时需要挂载 docker /var/run/docker.sock 文件,用于请求 docker API。

你也可以开启 docker tcp 连接地址,并通过 DOCKER_HOST 环境变量指定[开启 docker tcp 连接方式](zh-cn/manual/system/remote)
你也可以开启 docker tcp 连接地址,并通过 DOCKER_HOST 环境变量创建面板[开启 docker tcp 连接方式](zh-cn/manual/system/remote)

```
docker run -it -d --name dpanel --restart=always \
Expand All @@ -77,12 +75,11 @@ docker run -it -d --name dpanel --restart=always \
-v dpanel:/dpanel -e APP_NAME=dpanel dpanel/dpanel:latest
```


##### 自定义面板名称
#### 自定义面板名称

面板内部会获取 dpanel 的容器信息,在创建时必须使用 dpanel 名称。

如果你想更改创建的容器名称,必须再指定 APP_NAME 环境变量
如果你想更改创建的容器名称,必须再指定 APP_NAME 环境变量,请保证 APP_NAME 环境变量与面板容器名称一致。

```
docker run -it -d --name my-dpanel --restart=always \
Expand All @@ -91,11 +88,12 @@ docker run -it -d --name my-dpanel --restart=always \
-v dpanel:/dpanel -e APP_NAME=my-dpanel dpanel/dpanel:latest
```

##### 更新面板
#### 更新或重建面板

> 如果重新安装面板时发现无法配置管理员用户密码,请更换挂载目录地址或是删除之前的挂载目录数据
更新与重建的区别就在于是否保留之前面板挂载的目录(/dpanel)数据。\
如果删除宿主机挂载目录或是重新指定目录,则为重建面板。

更新面板等价于保留挂载目录或是挂载存储卷,重建面板容器。[升级面板](/zh-cn/manual/container/update)
更新面板则等价于保留挂载目录或是挂载存储卷,重建面板容器。[升级面板](/zh-cn/manual/setting/upgrade)

#### 访问地址

Expand All @@ -105,7 +103,3 @@ http://127.0.0.1:8807

配置中的 -p 8807:8080 指定面板对外暴露的访问端口,可根据实际情况进行修改

#### 默认帐号

admin / admin

0 comments on commit 33158c8

Please sign in to comment.