LOAKPHP部署教程：宝塔面板安装、Go项目配置、SSL与后台访问

本文提供一套完整的 LOAKPHP 部署教程，详细介绍如何通过宝塔面板上传程序、安装 Go 运行环境、配置 Go 项目、绑定授权域名、开启外网映射并申请 SSL 证书。按照以下步骤操作，即可进入 LOAKPHP 安装页面并完成系统初始化。

一、LOAKPHP 部署前的准备工作

开始安装 LOAKPHP 前，请确认服务器环境和相关资料已经准备完毕：

• LOAKPHP 完整版 ZIP 安装包
• 已安装并可正常登录的宝塔面板
• 有效的 LOAKPHP 程序授权码
• 已经完成 DNS 解析的授权域名
• 可正常使用的数据库及数据库账号

建议提前将授权域名解析到服务器公网 IP，并检查解析是否生效，以免项目创建完成后无法通过域名访问。

二、在宝塔面板创建 LOAKPHP 项目目录

1. 登录宝塔面板，点击左侧菜单中的文件，进入文件管理页面。

2. 创建一个新的项目目录。本文使用 LOAKPHP 作为目录名称，你也可以根据服务器目录规划自定义名称。

建议将项目放在独立目录中，避免与其他网站或应用程序文件混合存放。

三、上传并解压 LOAKPHP 完整版安装包

1. 进入刚刚创建的 LOAKPHP 项目目录。

2. 将 LOAKPHP 完整版 ZIP 安装包上传到当前目录，然后在宝塔面板中执行解压操作。

3. 解压完成并确认文件无误后，可以删除 ZIP 压缩包，减少服务器存储空间占用。

检查 LOAKPHP 文件结构

解压后，请确认项目根目录至少包含以下四项：

• config
• database
• template
• LOAKPHP 可执行文件

如果缺少其中任意文件或目录，通常表示安装包不完整或上传、解压过程出现异常。建议重新下载完整版安装包并再次解压。

设置项目目录权限

请将项目文件和目录的运行用户设置为 www，权限建议设置为 755，确保程序能够正常读取文件并启动运行。涉及写入操作的目录，应根据程序要求单独授予必要权限，避免直接为全部文件设置过高权限。

四、在宝塔面板安装 Go 运行环境

1. 返回宝塔面板首页，点击左侧菜单中的网站。

2. 进入Go 项目管理页面。

3. 点击SDK 版本管理，切换到所有版本，安装 Go 1.21 或更高版本。本文示例使用 Go 1.23.2。

如果版本列表中没有需要的 Go SDK，请先点击更新版本列表，等待列表刷新后再进行安装。

4. Go SDK 安装完成后，返回 Go 项目管理页面并点击添加项目。

五、配置 LOAKPHP Go 项目参数

在宝塔面板添加 LOAKPHP Go 项目时，请按照以下说明填写配置参数：

• 项目可执行文件：选择项目目录中的 LOAKPHP 可执行文件。
• 项目名称：可以自定义，也可以直接填写 LOAKPHP。
• 项目端口：填写 8520，并勾选放行端口。
• 执行命令：保持宝塔面板默认设置，无需修改。
• 环境变量：选择无。
• 运行用户：选择 www。
• 开机启动：建议勾选，确保服务器重启后项目可以自动运行。
• 项目备注：根据实际需要填写。
• 绑定域名：填写已经获得授权并解析到当前服务器的域名。

填写完成后，请再次核对可执行文件路径、运行用户、端口和授权域名。确认无误后，点击确定创建项目。

端口提示：如果需要通过 服务器IP:8520 临时测试项目，请确认服务器安全组和宝塔防火墙均已放行 8520 端口。正式通过域名反向代理访问后，可根据实际安全策略限制该端口的公网访问。

六、配置授权域名、外网映射和 SSL 证书

LOAKPHP 项目创建完成后，点击项目右侧的设置，依次完成以下配置：

• 域名管理：确认绑定的是已授权域名，并确保该域名的 DNS 记录已经解析到当前服务器。
• 外网映射：确认外网映射功能已经开启，使用户可以通过绑定域名访问项目。
• SSL 证书：申请或上传有效证书并启用 HTTPS，提高数据传输和后台登录的安全性。

开启 HTTPS 后，建议使用 https://你的域名 测试访问。如果网站无法打开，请检查域名解析、外网映射、项目运行状态、服务器安全组、宝塔防火墙和端口配置。

七、访问 LOAKPHP 安装页面并完成初始化

完成项目和域名配置后，在浏览器中访问已绑定的授权域名。如果页面显示系统尚未安装，说明 LOAKPHP 已经成功启动，并且域名映射配置正常。

接下来按照安装页面提示填写数据库地址、数据库名称、数据库账号、数据库密码及其他必要信息，提交后即可完成 LOAKPHP 初始化安装。

LOAKPHP 后台登录地址

安装完成后，可以尝试通过以下地址访问 LOAKPHP 管理后台：

• https://你的域名/admin
• https://你的域名/#/admin

请将示例中的“你的域名”替换为实际绑定的授权域名。如果已经启用 SSL 证书，建议始终使用 HTTPS 地址登录后台。

八、LOAKPHP 部署常见问题

1. LOAKPHP 项目运行中，但域名无法访问怎么办？

可以先临时访问 服务器IP:8520，检查项目能否通过端口正常响应。如果端口也无法访问，请重点检查 Go 项目运行日志、实际监听端口、宝塔防火墙、服务器安全组及 8520 端口放行状态。

如果端口可以访问但域名无法打开，则应检查域名 DNS 解析、授权域名填写是否正确、外网映射是否开启，以及 SSL 证书和反向代理配置是否正常。

2. 解压后找不到 LOAKPHP 可执行文件怎么办？

请确认下载的是 LOAKPHP 完整版安装包，并检查文件是否上传完整。如果可执行文件存在但无法选择或运行，还需要检查文件权限、运行用户以及服务器系统架构是否符合程序要求。

3. LOAKPHP 后台地址可以自定义吗？

当前版本暂不支持自定义后台访问地址，请使用 域名/admin 或 域名/#/admin 进入管理后台。

4. LOAKPHP 授权码在哪里查看？

授权码通常会在授权成功后发送到绑定邮箱，也可能显示在程序下载或授权管理页面。如果无法找到授权码，请联系授权方或上级服务商查询。

5. 配置 SSL 后 HTTPS 无法访问怎么办？

请检查 SSL 证书是否与当前域名匹配、证书是否过期、443 端口是否开放，以及外网映射和 HTTPS 配置是否启用。如果使用 CDN，还需要确认 CDN 的 SSL 模式与源站配置一致。

LOAKPHP 部署教程总结

通过宝塔面板部署 LOAKPHP 的关键步骤包括：上传并解压完整版安装包、检查文件结构和目录权限、安装 Go 1.21 以上版本、创建 Go 项目、配置 8520 端口、绑定授权域名、开启外网映射以及部署 SSL 证书。完成以上操作后，即可通过域名进入安装页面，并使用 /admin 或 /#/admin 访问 LOAKPHP 后台。