新手必看：Superdesk本地开发环境搭建的7个关键步骤

新手必看：Superdesk本地开发环境搭建的7个关键步骤

【免费下载链接】superdeskSuperdesk is an end-to-end news creation, production, curation, distribution, and publishing platform.项目地址: https://gitcode.com/gh_mirrors/su/superdesk

Superdesk是一个端到端的新闻创作、制作、管理、分发和发布平台，为新闻机构提供完整的内容生产解决方案。本文将详细介绍如何在本地搭建Superdesk开发环境，帮助新手快速上手这个强大的新闻工作流工具。

1. 安装核心依赖：Docker Desktop与Volta

Superdesk开发环境需要两个关键工具支持：

• Docker Desktop：所有后端服务都运行在Docker容器中，确保服务隔离和环境一致性。安装后需保持Docker运行状态（可通过docker info命令验证）

• Volta：用于管理Node.js版本，从client/package.json文件中固定Node版本，避免版本兼容问题。安装完成后可通过volta --version命令检查是否成功

2. 获取项目代码

通过Git克隆Superdesk仓库到本地：

git clone https://gitcode.com/gh_mirrors/su/superdesk cd superdesk

3. 执行一键安装脚本

Superdesk提供了便捷的安装脚本，可自动完成大部分环境配置工作：

./scripts/dev/setup.sh

首次运行时脚本会执行以下操作：

• 验证Docker和Volta是否正确安装
• 在./client目录运行npm install安装前端依赖
• 初始化数据库并启动必要的Docker服务

提示：首次运行可能较慢（需要下载镜像、安装依赖和初始化数据库），后续运行会显著加快

4. 启动开发环境

使用Docker Compose启动开发环境：

docker compose -f docker-compose.dev.yml up -d

此命令会启动所有必要的后端服务，包括数据库、缓存等组件。

5. 运行前端开发服务器

在单独的终端中启动前端开发服务器：

cd client npm run start

这将启动Grunt开发服务器并监听文件变化，代码修改会实时反映到浏览器中。

6. 访问Superdesk应用

打开浏览器访问以下地址即可使用Superdesk：

http://localhost:9000

首次登录可使用默认凭据（具体信息可在安装完成后的提示中找到）。

7. 常用开发命令

掌握以下命令可提高开发效率：

• 停止服务（保留数据）：

  docker compose -f docker-compose.dev.yml stop

• 完全清除环境（删除数据）：

  docker compose -f docker-compose.dev.yml down -v

• 重新初始化数据库：

  ./scripts/dev/setup.sh --reinit

常见问题解决

• Docker未运行：打开Docker Desktop，等待鲸鱼图标停止动画后再重试
• Node版本问题：确保通过Volta安装Node，避免使用系统自带的Node版本
• 依赖安装失败：尝试删除client/node_modules目录后重新运行npm install

通过以上7个步骤，你已经成功搭建了Superdesk本地开发环境。接下来可以开始探索这个强大的新闻生产平台的各种功能，或进行自定义开发。更多高级配置和开发技巧可参考项目中的DEVSETUP.md文档。

【免费下载链接】superdeskSuperdesk is an end-to-end news creation, production, curation, distribution, and publishing platform.项目地址: https://gitcode.com/gh_mirrors/su/superdesk