跳转到主要内容

​
简介

要在 Square Cloud 上开发和托管 Lavalink 服务器，遵循一套结构化的配置和前置条件流程至关重要。本技术指南将涵盖整个过程，从初始设置到生产环境部署。

​
前置条件

  • Square Cloud 账户：通过注册页面使用你的邮箱进行注册。
  • 有效套餐：为你的应用提供专属资源和优化的性能。查看我们可用的套餐，选择最适合你需求的方案。
本指南运行在 Java 运行时上。

​
获取项目

从官方发布页面下载 Lavalink.jar。本指南使用 Lavalink v4：请选择最新的 4.x 版本（4.2.0 或更高），并确保你的机器人使用为 v4 构建且支持 DAVE 的 Lavalink 客户端（参见连接你的机器人）。
我们已经在 lavalink-web releases 中准备好了所有可供部署的内容，并已配置好 YouTube 插件。下载 project.zip 并上传，在部署 Lavalink 时，将环境变量中 LAVALINK_SERVER_PASSWORD 的占位值替换为一个长的随机密码。
在 Lavalink.jar 旁边创建一个 application.yml 文件。下面的最小配置监听 PORT 环境变量中的端口（Square Cloud 将其设为 80），并通过官方的 youtube-source 插件播放 YouTube，因为 Lavalink 内置的 YouTube 音源已被弃用：
application.yml
Lavalink 会在首次启动时下载该插件。其他所有选项（其他音源、滤镜、缓冲区）请参见官方示例文件。
请保留 address: 0.0.0.0，并且不要把端口替换为 80 以外的固定值：Square Cloud 会将你子域名的流量转发到应用的 80 端口。

​
设置强密码

将 password 的值替换为至少 32 个字符的强随机密码。如果不想把密码写在文件里，可以改为在 LAVALINK_SERVER_PASSWORD 环境变量中设置它：Lavalink 中环境变量的优先级高于 application.yml。你可以在上传表单的 Advanced configuration 中、在控制面板中应用的 Environment Variables 页面中，或通过 CLI 添加该变量：
管理环境变量的其他方式请参阅环境变量。

​
配置 Square Cloud

在 Lavalink.jar 旁边创建一个 squarecloud.app 文件。SUBDOMAIN 字段会将你的服务器发布到 https://<subdomain>.squareweb.app：
squarecloud.app
MAIN=Lavalink.jar 让 Square Cloud 使用 java -jar Lavalink.jar 启动服务器，MEMORY 是它的内存（单位 MB），AUTORESTART=true 会在它崩溃时重新启动（请参阅自动重启的工作方式）。

​
ZIP 中包含什么

  • Lavalink.jar
  • application.yml
  • squarecloud.app
将这三个文件放在同一个文件夹中，并将它们压缩为一个 .zip 文件，以便从控制面板上传。

​
部署并验证

​
通过控制面板

1

访问上传页面

访问上传页面并上传你的项目 zip 文件。
2

配置你的环境

上传 zip 后，你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目，请务必选择 “Web Publication” 并为项目设置子域名。
3

部署你的项目

最后，点击 “Deploy” 按钮，即可将项目托管到 Square Cloud。
部署完成后，你可以在控制面板中监控项目的状态和日志。
正在上传应用到 Square Cloud
4

确认你的应用已上线

首次部署通常在一分钟内完成。在控制面板中，等待你的应用状态显示为运行中，并检查日志中是否有启动错误。
如果你部署的是网站或 API，请在浏览器中打开 https://<your-subdomain>.squareweb.app，你应该能看到应用正常响应。如果你部署的是机器人，发送一条命令确认它已上线。
应用无法启动？请参见故障排除指南，了解最常见的原因和解决方法。

​
通过 CLI

要使用此方法，你的项目根目录中需要有一个名为 squarecloud.app 的配置文件。它告诉 Square Cloud 如何运行你的应用。

配置文件指南

了解如何创建定义你应用环境的 squarecloud.app 配置文件。
1

安装 CLI

安装 Square Cloud CLI。如果你已经安装，运行同一条命令即可更新：
2

登录

运行下面的命令。它会打开你的浏览器：在浏览器中批准登录后，CLI 即可使用。无需复制任何 API 密钥。如需在脚本和 CI 中使用，请参阅 CLI 身份验证。
3

上传你的项目

在项目文件夹中运行下面的命令。CLI 会将当前文件夹打包为 zip（排除 squarecloud.ignore 中列出的内容）并上传：
要上传你自己创建的 zip，请通过 --file 传入：
4

确认你的应用已上线

首次部署通常在一分钟内完成。直接在终端中检查你的应用状态和日志：
如果你部署的是网站或 API，请在浏览器中打开 https://<your-subdomain>.squareweb.app，你应该能看到应用正常响应。如果你部署的是机器人，发送一条命令确认它已上线。
应用无法启动？请参见故障排除指南，了解最常见的原因和解决方法。

​
连接你的机器人

Lavalink 在 Square Cloud 内部监听 80 端口，但你的机器人通过公共边缘网络连接，而边缘网络在 443 端口提供 HTTPS。请在你的 Lavalink 客户端中这样配置节点（字段名称因库而异）：
自 2026 年 3 月起，Discord 只允许支持 DAVE（其语音端到端加密）的机器人加入语音频道。Lavalink 从 4.2.0 版本开始支持 DAVE，你的机器人使用的 Lavalink 客户端也必须支持：否则机器人能连接到 Lavalink，却无法加入语音频道。

​
常见错误

使用 80 端口或 secure: false 连接会失败：请使用 443 端口和 secure: true，如连接你的机器人中所示。如果连接以代码 1006 关闭，请参见 Lavalink connection closed with code 1006。

​
后续步骤

Discord 机器人

托管连接到你的 Lavalink 服务器的音乐机器人。

Discord 机器人错误

修复无效令牌、缺少 intents 以及 Lavalink 连接错误。

Java 运行时

Square Cloud 如何运行 Java 应用。
有关 Lavalink 的更多信息，请参阅 Lavalink 官方文档。

​
联系我们

如果你仍然遇到技术问题，我们的专业支持团队可以为你提供帮助。联系我们，我们很乐意协助你解决任何问题，支持质量正是开发者给予 Square Cloud 4.9/5 评分（共 402 条评价）（Google 与 Trustpilot）的重要原因之一。