LuaRocks项目安装指南：解决cURL下载Lua源码包问题

2025-06-24 15:38:37作者：平淮齐Percy

在LuaRocks项目的Unix系统安装文档中，存在一个关于使用cURL命令下载Lua源码包的常见问题。本文将详细分析问题原因，并提供多种解决方案，帮助开发者顺利完成Lua和LuaRocks的安装。

问题现象

当用户按照文档执行以下命令时：

curl -R -O http://www.lua.org/ftp/lua-5.3.5.tar.gz

会遇到"gzip: stdin: not in gzip format"错误。这是因为实际下载的不是预期的gzip压缩包，而是一个HTML文件。

问题分析

通过检查下载内容发现，服务器返回的是301重定向响应：

<html>
<head><title>301 Moved Permanently</title></head>
<body>
<center><h1>301 Moved Permanently</h1></center>
<hr><center>nginx/1.20.1</center>
</body>
</html>

根本原因是Lua官方网站已经从HTTP协议迁移到了HTTPS协议，而cURL默认不会自动跟随重定向。

解决方案

方案一：使用cURL的-L参数

curl -L -R -O http://www.lua.org/ftp/lua-5.3.5.tar.gz

-L参数让cURL跟随重定向，可以正确下载文件。

方案二：直接使用HTTPS协议

curl -R -O https://www.lua.org/ftp/lua-5.3.5.tar.gz

直接使用HTTPS地址，避免重定向问题。

方案三：使用wget工具

wget http://www.lua.org/ftp/lua-5.3.5.tar.gz

wget默认会跟随重定向，无需额外参数。

最佳实践建议

版本更新：文档中使用的Lua 5.3.5版本较旧，建议更新到最新稳定版(当前为5.4.7)
文档改进：安装文档应该：
- 使用HTTPS协议而非HTTP
- 包含-L参数或建议使用wget
- 提供Lua官方下载页面链接而非固定版本
安装流程优化：

# 下载最新版Lua
curl -L -R -O https://www.lua.org/ftp/lua-5.4.7.tar.gz
# 解压并编译
tar zxf lua-5.4.7.tar.gz
cd lua-5.4.7
make all test
sudo make install

技术背景

HTTP 301状态码表示永久重定向，浏览器和wget会自动处理，但cURL需要明确指定-L参数
现代网站普遍从HTTP迁移到HTTPS，安装脚本应考虑这种变化
包管理工具应该尽量使用最新稳定版本，避免潜在风险

通过以上分析和解决方案，开发者可以更顺利地完成Lua和LuaRocks的安装，避免因协议变更导致的安装失败问题。

luarocks

LuaRocks is the package manager for the Lua programming language.

项目地址：https://gitcode.com/gh_mirrors/lu/luarocks

登录后查看全文