Apollo怎么启动Windows：从安装到一键运行的完整教程

关键词：Apollo启动Windows、Apollo安装Windows、Apollo控制台启动、Apollo地图调试

如果你说的 Apollo 是百度的自动驾驶开发平台，那么“apollo怎么启动windows”通常有两种意思：

在 Windows 电脑上启动 Apollo 环境
在 Windows 上打开 Apollo 的可视化界面或服务

这里要先说明一个关键点：
Apollo 官方主流开发环境是基于 Linux 的，最常见是 Ubuntu。
也就是说，Apollo 不能像普通软件那样直接在 Windows 里双击启动。如果你是 Windows 用户，通常需要通过 WSL2、虚拟机、双系统 来运行 Apollo。

下面我按新手也能看懂的方式，把“Windows 下怎么启动 Apollo”讲清楚。

一、先搞清楚：Apollo 为什么不能直接在 Windows 启动

Apollo 是一个比较重的自动驾驶开发框架，里面涉及：

Docker
Bazel 编译
Linux 内核特性
依赖库环境
GPU、驱动、传感器仿真等

这些内容大多是围绕 Ubuntu Linux 设计的。
所以你在 Windows 上直接装 Apollo，常见结果就是：

依赖装不上
编译报错
Docker 环境不兼容
启动脚本跑不起来
图形界面可以开，但核心服务起不来

结论：

纯 Windows 本地环境，不建议直接跑 Apollo
最稳妥的方式是：Windows + WSL2 或 Windows + 虚拟机 Ubuntu

二、Apollo 在 Windows 上的几种启动方式

方案1：用 WSL2 在 Windows 上运行 Apollo

这是目前最适合 Windows 用户的方式，优点是：

不用装双系统
比虚拟机更轻量
适合开发调试
可以直接在 Windows 里打开 Ubuntu 环境

适合人群

Windows 10 / Windows 11 用户
想快速体验 Apollo
不想折腾双系统

方案2：用虚拟机安装 Ubuntu，再启动 Apollo

比如：

VMware
VirtualBox

优点：

环境独立
出问题不影响宿主系统

缺点：

占内存和CPU
图形界面和仿真性能一般
对显卡要求更高时会比较吃力

适合人群

只是学习 Apollo 基础操作
电脑配置还可以
不想改系统结构

方案3：直接装双系统 Ubuntu + Windows

这是最稳的方案，尤其适合要长期玩 Apollo 的人。

优点：

性能最好
兼容性最好
官方文档最容易对照

缺点：

要分区
安装麻烦一点
不熟悉的话容易误操作

适合人群

认真做 Apollo 开发
需要稳定运行
后续还要接仿真、感知、规划模块

三、Windows 上启动 Apollo 的推荐做法：WSL2 方案

下面重点讲最实用的 Windows 启动 Apollo 方法。

四、准备工作

1. 检查你的 Windows 版本

建议使用：

Windows 10 2004 及以上
Windows 11 更好

按下 Win + R，输入：

winver

如果版本太老，建议先升级系统。

2. 开启虚拟化

Apollo 或 WSL2 依赖 CPU 虚拟化能力。

检查方法：

任务管理器 → 性能 → CPU
看右下角是否显示：

虚拟化：已启用

如果是“已禁用”，需要进 BIOS 开启：

常见项目名：

Intel Virtualization Technology
VT-x
AMD SVM

开启后保存退出。

3. 安装 WSL2

以管理员身份打开 PowerShell，输入：

wsl --install

如果你的系统较老，可能需要手动开启组件。
安装完成后重启电脑。

4. 安装 Ubuntu

推荐安装：

Ubuntu 20.04
或 Apollo 版本要求对应的 Ubuntu 版本

在 Microsoft Store 里搜索 Ubuntu 并安装。
安装完成后，首次打开会让你设置用户名和密码。

五、在 Windows 里启动 Apollo 的完整步骤

下面以 WSL2 + Ubuntu 为例讲解。

第1步：进入 Ubuntu 环境

打开开始菜单，搜索 Ubuntu，点击运行。

进入后，你会看到类似命令行窗口。

第2步：更新系统依赖

先执行：

sudo apt update
sudo apt upgrade -y

这一步是为了让系统基础环境更干净。

第3步：安装 Apollo 需要的基础工具

常见会用到这些：

sudo apt install -y git curl wget vim docker.io python3-pip

如果 Apollo 版本要求更细，还需要按官方文档补充依赖。

第4步：配置 Docker

Apollo 很多版本会使用 Docker 运行。

启动 Docker：

sudo service docker start

设置开机启动：

sudo systemctl enable docker

如果你是 WSL2 环境，有时 systemctl 不一定默认可用，这种情况可以先用：

sudo service docker start

然后查看状态：

docker --version

能正常显示版本号就说明 Docker 基础可用。

第5步：拉取 Apollo 代码

一般做法是从 GitHub 获取源码：

git clone https://github.com/ApolloAuto/apollo.git
cd apollo

如果你已经有源码包，就直接进入对应目录。

第6步：启动 Apollo 开发环境

Apollo 常见启动方式是进入 Docker 容器或执行脚本。

你可以先看项目里有没有类似启动脚本：

ls

常见可能会有：

docker/scripts/dev_start.sh
scripts/bootstrap.sh
apollo.sh

例如，如果是开发环境脚本，常见执行方式类似：

bash docker/scripts/dev_start.sh

然后进入容器：

bash docker/scripts/dev_into.sh

不同 Apollo 版本脚本名称会有差异，所以一定要以你当前版本仓库内的说明为准。

第7步：启动 Apollo 控制台

Apollo 的启动通常不只是一个程序，而是一整套服务。

常见流程是：

进入 Apollo Docker 环境
启动后台模块
打开 Dreamview 控制台
加载车辆、地图、仿真场景

例如你可能会看到类似：

bash scripts/bootstrap.sh

或者：

cyber_launch start

具体命令会随版本不同而变化。

六、Apollo 启动后，Windows 怎么打开界面

很多人问的“启动 Windows”其实是想问：在 Windows 上怎么打开 Apollo 界面。

如果 Apollo 服务已经启动，通常可以在 Windows 浏览器里访问：

http://localhost:8888

或者：

http://127.0.0.1:8888

有些版本是 Dreamview 界面，它就是 Apollo 的可视化控制台。
如果页面打不开，检查下面几点：

检查1：服务有没有启动成功

在 Ubuntu 里执行：

ps -ef | grep dreamview

或者查看 Apollo 相关进程是否在运行。

检查2：端口有没有被占用

在 Ubuntu 中执行：

netstat -tulnp | grep 8888

如果端口被占了，换端口或关闭占用程序。

检查3：浏览器访问地址是否正确

有些情况下 Apollo 服务是在 WSL 内部地址，不一定能直接用 localhost。
这时可以查看 WSL 的 IP：

ip addr

然后用对应 IP 加端口访问。

七、如果你是“想在 Windows 启动 Apollo 软件”，这里要注意

如果你指的是某个叫 Apollo 的独立 Windows 软件，而不是百度自动驾驶 Apollo，那么启动方式完全不同。

常见做法是：

双击桌面图标
在开始菜单找到 Apollo
右键以管理员身份运行
检查是否缺少运行库
看是否被杀毒软件拦截

这类软件通常还要排查：

.NET Framework
VC++ 运行库
Java 环境
权限不足
安装路径有中文或空格

如果你说的是这种 Apollo，可以把软件全名发出来，启动方法会完全不一样。

八、常见问题和解决办法

问题1：Windows 里装了 Apollo，但启动报错

原因：

系统不是 Ubuntu
Docker 不完整
依赖没装全
版本不匹配

解决办法：

优先换 WSL2 或虚拟机 Ubuntu
对照官方 README 补依赖
不要混用多个版本的 Apollo

问题2：Docker 启动不了

排查顺序：

检查虚拟化是否开启
检查 Docker 是否安装
检查 Docker 服务是否启动
检查当前用户有没有 docker 权限

可执行：

sudo usermod -aG docker $USER
newgrp docker

然后重新登录。

问题3：Apollo 页面打不开

可能原因：

服务没启动
端口不对
防火墙拦截
浏览器访问地址错误

处理方法：

先看后台进程
再查端口
尝试 localhost 和 WSL IP
换 Chrome / Edge 浏览器

问题4：编译特别慢

原因： Apollo 本身就比较吃资源。

建议配置：

CPU：6 核以上
内存：16GB 起步，建议 32GB
硬盘：SSD
显卡：如果要仿真，尽量用独显

九、最稳妥的启动建议

如果你是新手，我给你最直接的结论：

想在 Windows 上“启动 Apollo”

优先按这个顺序选：

先用 WSL2 + Ubuntu
不行就上 虚拟机 Ubuntu
如果长期开发，直接装 双系统 Ubuntu

不建议的做法

直接在纯 Windows 上硬装 Apollo
乱下网上的“Windows版 Apollo”
不看版本说明就执行脚本
跳过 Docker 和依赖检查

十、实际操作总结

如果你现在手上是 Windows 电脑，想启动 Apollo，最短路径就是：

开启 BIOS 虚拟化
安装 WSL2
安装 Ubuntu
装 Docker 和基础依赖
拉取 Apollo 源码
运行官方启动脚本
用浏览器打开 Dreamview 界面

十一、给新手的简单版流程

如果你只想要“照着做”的版本，可以按这个顺序：

Windows 上启动 Apollo 简化步骤

Win + R 输入 winver，确认系统版本够新
去 BIOS 打开虚拟化
管理员 PowerShell 执行：
```
wsl --install
```
安装 Ubuntu
打开 Ubuntu，执行：
```
sudo apt update && sudo apt upgrade -y
```

安装 Docker：

sudo apt install -y docker.io
sudo service docker start

下载 Apollo 源码：

git clone https://github.com/ApolloAuto/apollo.git
cd apollo

按对应版本的脚本启动
浏览器访问 localhost:8888

十二、注意事项

Apollo 对系统环境要求高，版本一定要对
Docker、Ubuntu、Apollo 版本不要乱配
Windows 只能作为宿主系统，核心运行环境最好还是 Linux
内存低于 16GB 时，体验会比较差
如果只是学习，先把启动流程跑通，再考虑仿真和深度开发

结语

Apollo 不能像普通 Windows 软件那样直接启动，最实用的方法是通过 WSL2、虚拟机或双系统在 Ubuntu 环境中运行。
如果你的目标是“在 Windows 电脑上启动 Apollo 并打开控制台”，推荐先搭好 WSL2 + Ubuntu + Docker，再按 Apollo 版本的官方脚本启动服务，最后通过浏览器访问控制台界面。

如果你愿意，我可以继续直接给你写一篇 “Windows 11 上安装并启动 Apollo 的详细图文版步骤”，按小白操作顺序一步一步列出来。