docs/versioned_docs/version-2.8/developer-guide/core/run.md

title	description
开发环境运行	开发环境运行的指南

:::info 在此之前，我们推荐你先阅读《准备工作》，检查本地环境是否满足要求。 :::

项目结构说明

目前如果需要完整的运行 Halo，总共需要三个部分：

1. Halo 主项目（halo-dev/halo）
2. Console 控制台（托管在 Halo 主项目）
3. 主题（Halo 主项目内已包含默认主题）

:::info 说明 当前 Halo 主项目并不会将 Console 的构建资源托管到 Git 版本控制，所以在开发环境是需要同时运行 Console 项目的。当然，在我们的最终发布版本的时候会在 CI 中自动构建 Console 到 Halo 主项目。 :::

克隆项目

如果你已经 fork 了相关仓库，请将以下命令中的 halo-dev 替换为你的 GitHub 用户名。

git clone https://github.com/halo-dev/halo

# 或者使用 ssh 的方式 clone（推荐）

git clone git@github.com:halo-dev/halo.git

:::warning 从 2.4.0 开始，Console 项目已经合并到 Halo 主项目，所以不再需要单独克隆 Console 的项目仓库。

详情可查阅：https://github.com/halo-dev/halo/issues/3393 :::

运行 Console

cd path/to/halo

Linux / macOS 平台：

make -C console dev

Windows 平台：

cd console

pnpm install

pnpm build:packages

pnpm dev

最终控制台打印了如下信息即代表运行正常：

VITE v3.1.6  ready in 638 ms

➜  Local:   http://localhost:3000/console/

:::info 提示 请不要直接使用 Console 的运行端口（3000）访问，会因为跨域问题导致无法正常登录，建议按照后续的步骤以 dev 的配置文件运行 Halo，在 dev 的配置文件中，我们默认代理了 Console 的访问地址，所以后续访问 Console 使用 http://localhost:8090/console 访问即可，代理的相关配置：

halo:
  console:
    proxy:
      endpoint: http://localhost:3000/
      enabled: true

:::

运行 Halo

1. 在 IntelliJ IDEA 中打开 Halo 项目，等待 Gradle 初始化和依赖下载完成。

2. 修改 IntelliJ IDEA 的运行配置

   1. macOS / Linux 将 Active Profiles 改为 dev，如图所示：
   2. Windows 将 Active Profiles 改为 dev,win，如图所示：

3. 点击 IntelliJ IDEA 的运行按钮，等待项目启动完成。

4. 或者使用 Gradle 运行

   # macOS / Linux
   ./gradlew bootRun --args="--spring.profiles.active=dev"
   
   # Windows
   gradlew.bat bootRun --args="--spring.profiles.active=dev,win"
   

5. 最终访问 http://localhost:8090/console 即可进入控制台。访问 http://localhost:8090 即可进入站点首页。

:::info 开发环境下，超级管理员的默认用户名为 admin，默认密码为 admin。也可通过修改 application-dev.yaml 配置文件进行更改：

halo:
  security:
    initializer:
      super-admin-username: admin
      super-admin-password: admin

:::