Skip to content

Commit d1cdc6c

Browse files
docs: add non-interactive install instructions (#173)
1 parent 82a75a0 commit d1cdc6c

2 files changed

Lines changed: 85 additions & 1 deletion

File tree

docs/installation/online_installation.md

Lines changed: 66 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,78 @@
2525
GitHub Release 链接:https://github.com/1Panel-dev/1Panel/releases
2626

2727

28-
!!! note ""
28+
### 2.1 交互式安装
2929

30+
!!! note ""
3031
执行以下安装脚本,根据命令行提示完成安装。
32+
33+
```bash
34+
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"
35+
```
36+
37+
### 2.2 非交互安装
38+
39+
!!! note ""
40+
如需在批量部署、云服务器初始化脚本、CI/CD 等自动化场景中安装 1Panel,可以通过环境变量提前配置安装参数,并启用非交互模式。
41+
3142
```bash
43+
# 如需由安装脚本自动安装 Docker,请显式开启
44+
PANEL_NON_INTERACTIVE=true \
45+
PANEL_LANG=zh \
46+
PANEL_INSTALL_DIR=/opt \
47+
PANEL_PORT=18080 \
48+
PANEL_ENTRANCE=panelEntrance \
49+
PANEL_USERNAME=panelAdmin \
50+
PANEL_PASSWORD='ChangeMe_123456' \
51+
PANEL_INSTALL_DOCKER=y \
52+
PANEL_DOCKER_MODE=auto \
53+
PANEL_CONFIGURE_ACCELERATOR=n \
54+
PANEL_REPLACE_DAEMON_JSON=n \
3255
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"
3356
```
3457

58+
!!! warning "注意"
59+
- 请在生产环境中替换示例中的端口、安全入口、用户名和密码。
60+
- 非交互模式下,未配置的参数将使用默认值。
61+
- 为避免安装脚本在自动化场景中修改主机环境,Docker 安装和镜像加速默认不启用。如需自动安装 Docker,请显式设置 `PANEL_INSTALL_DOCKER=y`
62+
- 如果服务器已安装 Docker,通常无需设置 `PANEL_INSTALL_DOCKER`;如需配置 Docker 镜像加速,请显式设置 `PANEL_CONFIGURE_ACCELERATOR=y`
63+
- 示例中的环境变量仅对当前安装命令生效,不会写入系统环境。
64+
65+
!!! note "非交互安装参数"
66+
| 环境变量 | 命令行参数 | 说明 |
67+
| --- | --- | --- |
68+
| `PANEL_NON_INTERACTIVE` | `--non-interactive``-y` | 启用非交互模式,可设置为 `true``1``y``yes` |
69+
| `PANEL_LANG` | `--lang` | 设置安装语言,支持 `en``zh``fa``pt-BR``ru` |
70+
| `PANEL_INSTALL_DIR` | `--install-dir` | 设置安装目录,需使用绝对路径,默认 `/opt` |
71+
| `PANEL_PORT` | `--port` | 设置面板端口,未设置时随机生成可用端口 |
72+
| `PANEL_ENTRANCE` | `--entrance` | 设置安全入口,支持 3-30 位字母、数字、下划线 |
73+
| `PANEL_USERNAME` | `--username` | 设置面板用户名,支持 3-30 位字母、数字、下划线 |
74+
| `PANEL_PASSWORD` | `--password` | 设置面板密码,支持 8-30 位字母、数字及 `_!@#$%*,.?` 特殊字符 |
75+
| `PANEL_INSTALL_DOCKER` | `--install-docker` | 是否安装 Docker,可设置为 `y``n`,非交互模式默认 `n` |
76+
| `PANEL_DOCKER_MODE` | `--docker-mode` | Docker 安装方式,支持 `auto``builtin``online` |
77+
| `PANEL_CONFIGURE_ACCELERATOR` | `--configure-accelerator` | 是否配置 Docker 镜像加速,可设置为 `y``n`,非交互模式默认 `n` |
78+
| `PANEL_REPLACE_DAEMON_JSON` | `--replace-daemon-json` | 当 `/etc/docker/daemon.json` 已存在时,是否替换该文件,可设置为 `y``n`,非交互模式默认 `n` |
79+
80+
!!! note ""
81+
也可以通过命令行参数传入配置:
82+
83+
```bash
84+
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)" -- \
85+
--non-interactive \
86+
--lang zh \
87+
--install-dir /opt \
88+
--port 18080 \
89+
--entrance panelEntrance \
90+
--username panelAdmin \
91+
--password 'ChangeMe_123456' \
92+
--install-docker y \
93+
--docker-mode auto \
94+
--configure-accelerator n \
95+
--replace-daemon-json n
96+
```
97+
98+
出于安全考虑,建议优先使用 `PANEL_PASSWORD` 环境变量传入密码,避免密码直接出现在命令参数中。
99+
35100
!!! note ""
36101
如果遇到 Docker 安装失败等问题,可以尝试运行以下脚本:
37102

docs/installation/package_installation.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,25 @@
6868
/bin/bash install.sh
6969
```
7070

71+
!!! note ""
72+
如需在离线环境中批量部署,也可以通过环境变量启用非交互安装。参数说明请参考 [在线安装 - 非交互安装](online_installation.md#22)
73+
74+
```bash
75+
# 如目标服务器未安装 Docker,请显式开启
76+
PANEL_NON_INTERACTIVE=true \
77+
PANEL_LANG=zh \
78+
PANEL_INSTALL_DIR=/opt \
79+
PANEL_PORT=18080 \
80+
PANEL_ENTRANCE=panelEntrance \
81+
PANEL_USERNAME=panelAdmin \
82+
PANEL_PASSWORD='ChangeMe_123456' \
83+
PANEL_INSTALL_DOCKER=y \
84+
PANEL_DOCKER_MODE=auto \
85+
PANEL_CONFIGURE_ACCELERATOR=n \
86+
PANEL_REPLACE_DAEMON_JSON=n \
87+
/bin/bash install.sh
88+
```
89+
7190
## 5. 升级版本
7291

7392
### 5.1 解压离线包

0 commit comments

Comments
 (0)