企业官网建设流程全解析

安装mineadmin后端

在全新的 Windows 10 电脑上，通过 Docker Desktop 来安装 MineAdmin 最新版，最推荐的方式是使用 Docker Compose。这种方式最为省心，能一键把后端、数据库、缓存等服务都启动起来，自动处理好它们之间的网络连接。

整个流程主要分几步，跟着操作就行：

📝 第一步：准备工作，安装 Docker Desktop
开启 Windows 虚拟化功能：这是运行 Docker 的基础。可以在“控制面板” -> “启用或关闭 Windows 功能”里，勾选 “Hyper-V” 和 “Windows 子系统 (WSL 2)”，Windows 虚拟机监控程序平台，然后根据提示重启电脑。

下载并安装 Docker Desktop：去 Docker 官网 下载 Docker Desktop for Windows 的安装程序。运行安装时，如果提示是否使用 WSL 2，建议选“是”，性能会更好。

启动并验证：安装完成后，启动 Docker Desktop。你可以打开命令行（cmd 或 PowerShell），输入 docker --version。如果能看到版本号，就说明安装成功了。

🚀 第二步：使用 Docker Compose 一键启动环境
获取项目代码：在你电脑的任意工作目录下（比如 D:\projects），打开命令行，运行以下命令，把 MineAdmin 项目代码克隆到本地：

bash
git clone https://github.com/mineadmin/MineAdmin.git
cd MineAdmin
启动所有服务容器：项目根目录下有一个 docker-compose.yml 文件，它定义了所有需要的服务。在项目根目录下运行以下命令，Docker 就会自动下载镜像并启动后端服务、MySQL 和 Redis：

以管理员身份修改 找到 hyperf 服务下的 image 配置，把 8.1 改成 8.2
image: mysql:8.2
image: hyperf/hyperf:8.2-alpine-v3.19-swoole

如果提示# 更新 WSL 组件到最新版
wsl --update

彻底关闭 WSL，重置其状态
wsl --shutdown
再次尝试更新，这次使用 --web-download 参数，强制从网络下载最新包
wsl --update --web-download

bash
docker-compose up -d
第一次运行会需要下载一些镜像，这个过程可能需要几分钟，耐心等待一下就好。

检查容器运行状态：运行下面的命令，确保 hyperf、mysql、redis 这几个容器的状态都是 Up 或 Running：

bash
docker-compose ps
⚙️ 第三步：进入容器，安装并初始化项目
服务都启动后，还需要进入后端服务的容器里，安装 PHP 依赖并初始化数据库。

进入容器：

bash
docker-compose exec hyperf /bin/sh
安装 PHP 依赖：在容器内执行 composer install，这一步会把项目需要的 PHP 包都装上。根据网络情况，可能需要几分钟。

bash
composer install
运行安装命令：这个命令会引导你配置数据库和 Redis 信息，并完成数据表的创建和初始化数据填充。

bash
php bin/hyperf.php mine:install
在安装过程中，会提示你输入数据库等信息，这里可以参考下面的填写：

数据库连接：DB_HOST 填写 mysql（因为容器之间通过服务名通信），端口 3306，用户名 root，密码 12345678（密码可以在 docker-compose.yml 文件中找到）。

Redis 连接：REDIS_HOST 填写 redis，端口 6379，密码为空。

退出容器：完成所有命令后，输入 exit 退出容器。

注意：需要启动服务，进入docker里面，可能需要
进入容器
docker-compose exec hyperf /bin/sh

手动启动 Hyperf（前台运行，可以看到详细日志）
php bin/hyperf.php start

✅ 第四步：验证安装成果
验证后端：在浏览器中访问 http://localhost:9501，如果你能看到一个 JSON 格式的返回信息，就说明后端服务已经正常运行了。

Windows安装node.js LST版本，重新打开cmd

验证前端（可选）：MineAdmin 是一个前后端分离的项目，需要单独启动前端。你可以按照项目文档，在 web 目录下使用 npm install 和 npm run dev 来启动前端开发服务，然后访问 http://localhost:8101 进入后台登录页面。初始账号密码通常是 admin / 123456。

最后检查一下服务是否开启，前后端的服务

启动前端：npm run dev

后端启动：
1、启动服务：docker-compose up -d
2、进入容器：docker-compose exec hyperf bash
3、启动：php bin/hyperf.php start

进入web代码目录
1、npm run dev

2、如果用volta，安装volta install node@24，切换node版本
npm run dev

3、volta run --node 24 npm run dev

切换，全局
volta install node@<版本号>
临时使用某版本运行命令（不改变默认）
volta run --node 22 npm run dev

进入应用容器
docker-compose exec hyperf bash

安装依赖（按场景二选一）

开发环境:
composer install -vvv

生产环境安装:
composer install --no-dev --optimize-autoloader

数据库迁移
php bin/hyperf.php migrate

数据填充
php bin/hyperf.php db:seed

如果npm install安装报错，如下：
D:\docker projects\MineAdmin\web>npm install
npm warn Unknown project config “shamefully-hoist”. This will stop working in the next major version of npm. Seenpm help npmrcfor supported config options.
npm warn Unknown project config “strict-peer-dependencies”. This will stop working in the next major version of npm. Seenpm help npmrcfor supported config options.
npm error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: mineadmin-ui@3.2.1
npm error Found: vite@8.1.5
npm error node_modules/vite
npm error dev vite@“^8.0.7” from the root project
npm error peer vite@“*” from @vitejs/devtools@0.3.4
npm error node_modules/@vitejs/devtools
npm error peerOptional @vitejs/devtools@“^0.3.0” from vite@8.1.5
npm error
npm error Could not resolve dependency:
npm error peer vite@“^4 || ^5” from vite-plugin-chunk-split@0.5.0
npm error node_modules/vite-plugin-chunk-split
npm error dev vite-plugin-chunk-split@“^0.5.0” from the root project
npm error
npm error Fix the upstream dependency conflict, or retry this command with --force or --legacy-peer-deps to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:
npm error C:\Users\Administrator\AppData\Local\npm-cache_logs\2026-07-23T08_55_55_185Z-eresolve-report.txt
npm notice
npm notice New major version of npm available! 11.16.0 -> 12.0.1
npm notice Changelog: https://github.com/npm/cli/releases/tag/v12.0.1
npm notice To update run: npm install -g npm@12.0.1
npm notice
npm error A complete log of this run can be found in: C:\Users\Administrator\AppData\Local\npm-cache_logs\2026-07-23T08_55_55_185Z-debug-0.log

执行
方法一：使用 --legacy-peer-deps 忽略依赖冲突（推荐，最快）
bash
npm install --legacy-peer-deps

使用生产环境配置

composer install --no-dev --optimize-autoloader

清除配置缓存

php bin/hyperf.php config:clear

构建前端生产版本

cd web && pnpm build

💡 常见问题与建议
端口冲突怎么办？ 如果 3306、6379、9501 这些端口已经被其他程序占用，你需要修改 docker-compose.yml 文件中对应服务的端口映射，比如把 “9501:9501” 改成 “9502:9501”，把左侧的主机端口换成你电脑上空闲的端口。

数据库连不上？ 在 mine:install 过程中，如果数据库连不上，可以检查 .env 文件里的 DB_HOST 是否设置成了 mysql（这是 Docker Compose 内部的服务名，而不是 127.0.0.1）。