Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

docs: update the instructions for the initial administrator in the deployment document #244

Merged
merged 1 commit into from
Sep 1, 2023
Merged

docs: update the instructions for the initial administrator in the deployment document #244

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 1 addition & 5 deletions docs/getting-started/first-post.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,7 @@ description: 安装完成后，如何写下第一篇文章。

## 登录管理端

浏览器访问 `/console` 即可进入 Halo 管理端。用户名密码为部署在配置文件中时设置的 `halo.security.initializer.superadminusername` 和 `halo.security.initializer.superadminpassword`。

:::info
如果你在安装时没有设置 `halo.security.initializer.superadminpassword` 变量或忘记了设置的密码，可以参考[常见问题中的忘记密码章节](../user-guide/faq.md#忘记密码怎么办)进行处理。
:::
浏览器访问 `/console` 即可进入 Halo 管理端。

## 新建文章

Expand Down
29 changes: 4 additions & 25 deletions docs/getting-started/install/docker-compose.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ import DockerArgs from "./slots/docker-args.md"

1. 创建 Halo + PostgreSQL 的实例：

```yaml {24-34,51} title="~/halo/docker-compose.yaml"
```yaml {24-30,47} title="~/halo/docker-compose.yaml"
version: "3"

services:
Expand Down Expand Up @@ -85,10 +85,6 @@ import DockerArgs from "./slots/docker-args.md"
- --spring.sql.init.platform=postgresql
# 外部访问地址，请根据实际需要修改
- --halo.external-url=http://localhost:8090/
# 初始化的超级管理员用户名
- --halo.security.initializer.superadminusername=admin
# 初始化的超级管理员密码
- --halo.security.initializer.superadminpassword=P@88w0rd
halodb:
image: postgres:latest
container_name: halodb
Expand Down Expand Up @@ -116,7 +112,7 @@ import DockerArgs from "./slots/docker-args.md"

2. 创建 Halo + MySQL 的实例：

```yaml {24-34,59} title="~/halo/docker-compose.yaml"
```yaml {24-30,55} title="~/halo/docker-compose.yaml"
version: "3"

services:
Expand Down Expand Up @@ -147,10 +143,6 @@ import DockerArgs from "./slots/docker-args.md"
- --spring.sql.init.platform=mysql
# 外部访问地址，请根据实际需要修改
- --halo.external-url=http://localhost:8090/
# 初始化的超级管理员用户名
- --halo.security.initializer.superadminusername=admin
# 初始化的超级管理员密码
- --halo.security.initializer.superadminpassword=P@88w0rd

halodb:
image: mysql:8.0.31
Expand Down Expand Up @@ -205,14 +197,10 @@ import DockerArgs from "./slots/docker-args.md"
command:
# 外部访问地址，请根据实际需要修改
- --halo.external-url=http://localhost:8090/
# 初始化的超级管理员用户名
- --halo.security.initializer.superadminusername=admin
# 初始化的超级管理员密码
- --halo.security.initializer.superadminpassword=P@88w0rd
```
4. 仅创建 Halo 实例（使用已有外部数据库，MySQL 为例）：

```yaml {8,21-24} title="~/halo/docker-compose.yaml"
```yaml {8,12-20} title="~/halo/docker-compose.yaml"
version: "3"

services:
Expand All @@ -231,13 +219,8 @@ import DockerArgs from "./slots/docker-args.md"
- --spring.sql.init.platform=mysql
# 外部访问地址，请根据实际需要修改
- --halo.external-url=http://localhost:8090/
# 初始化的超级管理员用户名
- --halo.security.initializer.superadminusername=admin
# 初始化的超级管理员密码
- --halo.security.initializer.superadminpassword=P@88w0rd
# 端口号 默认8090
- --server.port=8090

```

参数详解：
Expand All @@ -256,7 +239,7 @@ import DockerArgs from "./slots/docker-args.md"
docker-compose logs -f
```

4. 用浏览器访问 `/console` 即可进入 Halo 管理页面，用户名和密码为在 `docker-compose.yaml` 文件中设置的 `superadminusername` 和 `superadminpassword`。
4. 用浏览器访问 /console 即可进入 Halo 管理页面，首次启动会进入初始化页面。

:::tip
如果需要配置域名访问，建议先配置好反向代理以及域名解析再进行初始化。如果通过 `http://ip:端口号` 的形式无法访问，请到服务器厂商后台将运行的端口号添加到安全组，如果服务器使用了 Linux 面板，请检查此 Linux 面板是否有还有安全组配置，需要同样将端口号添加到安全组。
Expand Down Expand Up @@ -366,10 +349,6 @@ services:
command:
# 外部访问地址，请根据实际需要修改
- --halo.external-url=https://yourdomain.com
# 初始化的超级管理员用户名
- --halo.security.initializer.superadminusername=admin
# 初始化的超级管理员密码
- --halo.security.initializer.superadminpassword=P@88w0rd
labels:
traefik.enable: "true"
traefik.docker.network: traefik
Expand Down
10 changes: 3 additions & 7 deletions docs/getting-started/install/docker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,9 +48,7 @@ import DockerArgs from "./slots/docker-args.md"
-p 8090:8090 \
-v ~/.halo2:/root/.halo2 \
halohub/halo:2.8 \
--halo.external-url=http://localhost:8090/ \
--halo.security.initializer.superadminusername=admin \
--halo.security.initializer.superadminpassword=P@88w0rd
--halo.external-url=http://localhost:8090/
```

:::info
Expand All @@ -67,7 +65,7 @@ import DockerArgs from "./slots/docker-args.md"

<DockerArgs />

1. 用浏览器访问 `/console` 即可进入 Halo 管理页面，用户名和密码为启动参数中的 `superadminusername` 和 `superadminpassword`。
1. 用浏览器访问 `/console` 即可进入 Halo 管理页面，首次启动会进入初始化页面。

:::tip
如果需要配置域名访问，建议先配置好反向代理以及域名解析再进行初始化。如果通过 `http://ip:端口号` 的形式无法访问，请到服务器厂商后台将运行的端口号添加到安全组，如果服务器使用了 Linux 面板，请检查此 Linux 面板是否有还有安全组配置，需要同样将端口号添加到安全组。
Expand Down Expand Up @@ -107,7 +105,5 @@ import DockerArgs from "./slots/docker-args.md"
-p 8090:8090 \
-v ~/.halo2:/root/.halo2 \
halohub/halo:2.8 \
--halo.external-url=http://localhost:8090/ \
--halo.security.initializer.superadminusername=admin \
--halo.security.initializer.superadminpassword=P@88w0rd
--halo.external-url=http://localhost:8090/
```
4 changes: 0 additions & 4 deletions docs/getting-started/install/other/traefik.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -107,10 +107,6 @@ services:
command:
# 外部访问地址，请根据实际需要修改
- --halo.external-url=https://yourdomain.com
# 初始化的超级管理员用户名
- --halo.security.initializer.superadminusername=admin
# 初始化的超级管理员密码
- --halo.security.initializer.superadminpassword=P@88w0rd
labels:
traefik.enable: "true"
traefik.docker.network: traefik
Expand Down
2 changes: 0 additions & 2 deletions docs/getting-started/install/slots/docker-args.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@
| `spring.r2dbc.password` | 数据库密码 |
| `spring.sql.init.platform` | 数据库平台名称，支持 `postgresql`、`mysql`、`h2` |
| `halo.external-url` | 外部访问链接，如果需要在公网访问，需要配置为实际访问地址 |
| `halo.security.initializer.superadminusername` | 初始超级管理员用户名 |
| `halo.security.initializer.superadminpassword` | 初始超级管理员密码 |
| `halo.cache.page.disabled` | 是否禁用页面缓存，默认为禁用，如需页面缓存可以手动添加此配置，并设置为 `false`。<br />开启缓存之后，在登录的情况下不会经过缓存，且默认一个小时会清理掉不活跃的缓存，也可以在 Console 仪表盘的快捷访问中手动清理缓存。 |

数据库配置：
Expand Down
Loading