爱站seo自学视频教程
本文档将带你从注册账号开始，一步步完成项目的创建、环境配置与首次部署，让你在最短时间内跑通完整流程。
新手入门 · QUICK START
前置准备
在开始之前，请确认你已经完成以下准备工作。如果没有，请先前往控制台注册账号。
- 一个可用的引路蜂云账号（支持邮箱或手机号注册）
- 本地已安装 Node.js 18+ 与 npm
- 具备基础的命令行操作能力
创建项目
打开终端，执行下面的命令安装官方 CLI 工具，并初始化一个全新的项目：
# 全局安装 CLI 工具
npm install -g create-star-app
# 在当前目录初始化项目
create-star-app init my-project
cd my-project初始化过程中会提示你选择项目模板，推荐新手直接选择 starter 模板，它已经内置了基础的目录结构和示例代码。
配置环境变量
复制示例配置并填入你的密钥。所有敏感信息请务必通过环境变量管理，不要硬编码到代码中。
cp .env.example .env
# .env 示例内容
API_KEY=your-access-key
REGION=ap-guangzhou
TIMEOUT=30000| 参数 | 说明 | 默认值 |
|---|---|---|
API_KEY | 访问密钥，从控制台「密钥管理」获取 | 无（必填） |
REGION | 服务部署区域 | ap-guangzhou |
TIMEOUT | 单次请求超时时间（毫秒） | 30000 |
切勿将 .env 文件提交到 Git 仓库。建议在
.gitignore 中加入 .env，避免密钥泄露造成安全风险。
启动与验证
完成配置后，运行开发服务器。看到控制台输出访问地址即代表启动成功：
npm run dev
# 输出：Local: http://localhost:3000在浏览器中打开该地址，如果页面正常显示欢迎界面，说明你的第一个项目已经成功跑起来了。
恭喜！你已经完成了从安装、配置到启动的完整流程。接下来可以查阅「基础配置」深入了解各项能力。
常见问题
如果启动过程中遇到问题，可以先看看下面这几个高频情况：
- 提示 API_KEY 无效：请确认密钥复制完整，且控制台中该密钥处于启用状态。
- 端口被占用：修改
.env中的端口，或关闭占用 3000 端口的进程。 - 依赖安装缓慢：可切换至国内镜像源
npm config set registry https://registry.npmmirror.com。
提示：文档会随版本持续更新，建议在开始前先确认当前平台的版本号，遇到与文档不符的地方请以控制台实际显示为准。