mirror of
https://github.com/halo-dev/docs.git
synced 2025-10-20 17:54:01 +00:00
106 lines
2.5 KiB
Markdown
106 lines
2.5 KiB
Markdown
---
|
||
title: 开发环境运行
|
||
description: 开发环境运行的指南
|
||
---
|
||
|
||
:::info
|
||
在此之前，我们推荐你先阅读[《准备工作》](./prepare)，检查本地环境是否满足要求。
|
||
:::
|
||
|
||
## 项目结构说明
|
||
|
||
目前如果需要完整的运行 Halo，总共需要三个部分：
|
||
|
||
1. Halo 主项目([halo-dev/halo](https://github.com/halo-dev/halo))
|
||
2. Console 控制台([halo-dev/console](https://github.com/halo-dev/console))
|
||
3. 主题
|
||
|
||
:::info 说明
|
||
当前 Halo 主项目并不会将 Console 的构建资源托管到 Git 版本控制，所以在开发环境是需要同时运行 Console 项目的。当然，在我们的最终发布版本的时候会在 CI 中自动构建 Console 到 Halo 主项目。
|
||
:::
|
||
|
||
## 克隆项目
|
||
|
||
如果你已经 fork 了相关仓库，请将以下命令中的 halo-dev 替换为你的 GitHub 用户名。
|
||
|
||
```bash
|
||
git clone https://github.com/halo-dev/halo
|
||
|
||
或者使用 ssh 的方式 clone（推荐）
|
||
|
||
git clone git@github.com:halo-dev/halo.git
|
||
```
|
||
|
||
```bash
|
||
git clone https://github.com/halo-dev/console
|
||
|
||
或者使用 ssh 的方式 clone（推荐）
|
||
|
||
git clone git@github.com:halo-dev/console.git
|
||
```
|
||
|
||
## 运行 Console
|
||
|
||
```bash
|
||
cd path/to/console
|
||
```
|
||
|
||
```bash
|
||
pnpm install
|
||
```
|
||
|
||
```bash
|
||
pnpm build:packages
|
||
```
|
||
|
||
```bash
|
||
pnpm dev
|
||
```
|
||
|
||
最终控制台打印了如下信息即代表运行正常：
|
||
|
||
```bash
|
||
VITE v3.1.6 ready in 638 ms
|
||
|
||
➜ Local: http://localhost:3000/console/
|
||
```
|
||
|
||
## 运行 Halo
|
||
|
||
1. 在 IntelliJ IDEA 中打开 Halo 项目，等待 Gradle 初始化和依赖下载完成。
|
||
2. 创建本地配置文件
|
||
|
||
复制 `src/main/resources/application-dev.yaml` 为 `application-local.yaml`，修改配置如下：
|
||
|
||
```yaml
|
||
halo:
|
||
console:
|
||
proxy:
|
||
endpoint: http://localhost:3000/
|
||
enabled: true
|
||
security:
|
||
initializer:
|
||
super-admin-username: admin
|
||
super-admin-password: admin
|
||
```
|
||
|
||
3. 修改 IntelliJ IDEA 的运行配置
|
||
|
||
将 Active Profiles 改为 `local`，如图所示：
|
||
|
||
|
||
|
||
4. 点击 IntelliJ IDEA 的运行按钮，等待项目启动完成。
|
||
|
||
5. 或者使用 Gradle 运行
|
||
|
||
```bash
|
||
# macOS / Linux
|
||
./gradlew bootRun --args="--spring.profiles.active=local"
|
||
|
||
# Windows
|
||
gradlew.bat bootRun --args="--spring.profiles.active=local"
|
||
```
|
||
|
||
6. 最终访问 `http://localhost:8090/console` 即可进入控制台。访问 `http://localhost:8090` 即可进入站点首页。
|