LiteSpeed Web Server logo LiteSpeed Web Server用户手册
主页

安装/卸载


最低系统要求

  • 操作系统：
    • Linux：kernel 3.0+
    • CentOS：7+
    • Ubuntu：18.04+
    • Debian：9+
    • FreeBSD：12.0+
  • CPU：
    • Intel：x86-64
    • ARM：aarch64（仅限Linux）
  • 内存：512MB及以上
  • 磁盘：
    • 安装：200MB
    • 运行：300MB及以上，交换空间取决于使用情况。

注意：在使用LXC容器（包括Proxmox）时，不建议使用受RAM限制的LSWS许可证。 LiteSpeed使用sysinfo()来检测内存大小，因此在LXC容器中， 由于它返回的是宿主机内存大小，您可能会触发RAM限制。无限RAM许可证则不存在这个问题。


安装


必须在命令行终端中执行安装。出于测试目的，非特权用户可以将LiteSpeed Web Server安装到主目录中。 对于生产用途，应将其安装到系统目录中。


在Mac OS X中，root用户默认被禁用。可以按照 Apple 网站上的说明启用。您也可以在不启用root用户的情况下，使用sudo命令将LSWS安装到系统目录中， 但系统文件夹仍然只能由root用户操作。这意味着每次您想从命令行终端控制LSWS （例如启动或停止LSWS）时，都必须使用sudo命令。


安装步骤

  1. 将安装包解压到方便的位置：
    tar xvfz lsws-xxxx.tar.gz 或 gunzip -c lsws-xxxx.tar.gz | tar xvf -
  2. 安装试用许可证密钥或序列号：
    • 试用许可证：

      试用许可证仅用于评估，下载后仅可使用15天。可在下载页面申请试用许可证。

      试用许可证密钥将作为确认邮件的附件发送给您。请将该附件保存为 trial.key，并复制到安装目录中。

      当您从试用许可证切换到正式许可证时，只需在完成以下步骤后再次运行安装脚本即可更新许可证。

    • 正式许可证：
      1. 可以在LiteSpeed 商店 租用或购买许可证。
      2. 订单成功处理后，确认邮件中会发送一个序列号。每个序列号仅允许安装在一台服务器上。
      3. 将序列号保存为安装目录中的serial.no （也就是install.sh所在目录）。 LiteSpeed产品注册服务器将在安装过程中使用该文件获取您的许可证密钥。

  3. 进入安装目录 cd lsws-xxxx， 然后运行命令 ./install.sh，这将启动LiteSpeed安装程序。

    请注意，只有以"root"用户运行此命令，您才能将服务器安装到系统目录中。 其他用户应将其安装到自己的主目录下。

    Mac OS X用户可以使用命令 sudo ./install.sh 将服务器安装到系统目录中。

  4. 阅读最终用户许可协议，并输入"Yes"以确认您同意该协议。
  5. 指定您希望安装LiteSpeed Web Server的目录。对于root用户，默认目录为 /usr/local/lsws。对于非特权用户，默认目录为其主目录。 请记住，非特权用户无法将服务器安装到系统目录中。
  6. 生成许可证请求。

    如果安装程序只找到序列号而未找到有效许可证密钥，它会提示生成许可证请求。 安装程序将自动与LiteSpeed产品注册服务器通信并获取有效许可证密钥。获取成功后， 会进入下一步；如果失败，安装程序将退出并留下一个许可证请求文件。

    如果自动过程失败，您可以通过在线商店客户区向许可证部门提交工单。

    注意：只有存在有效试用密钥或许可证密钥时，安装才会继续。

  7. 按照屏幕上的说明操作。安装程序会要求您设置以下内容：
    1. 如果检测到已安装的副本，安装程序会要求您选择升级、重新安装或更改目录。 选择升级将保留当前配置。
    2. WebAdmin控制台的管理员用户名和密码。
    3. 将与LSWS配合使用的控制面板（如果有）。
    4. 服务器进程将以哪个用户和用户组身份运行。
    5. 普通Web服务的TCP端口。
    6. WebAdmin控制台的TCP端口。
    7. 是否安装LiteSpeed PHP。
    8. root用户可以选择启用chroot。安装程序会自动设置初始chroot环境。 Chroot属于高级功能，如果没有进行配置调优，您的CGI可能无法正常工作。 除非您熟悉此功能，否则我们强烈建议不要启用chroot。 您始终可以稍后通过执行升级安装来启用它。

    最后，安装程序会询问您是否要安装AWStats附加模块以跟踪网站统计信息。 root用户还可以选择将LiteSpeed Web Server作为服务在系统启动时自动运行。 至此安装完成，安装程序可以立即启动服务器。


测试安装

  1. 有关如何控制服务器进程的详细信息，请参阅 管理指南。要启动服务器，只需运行 [your_install_dir]/bin/lswsctrl start。

  2. 要访问您的网站，请将浏览器指向 http://[address]:8088/， 其中[address]是您的Web服务器所在机器的IP地址或域名。 如果服务器就在您当前使用的机器上，请使用"localhost"。 "8088"是默认端口。如果您在安装过程中更改了端口，请使用您指定的端口。 浏览器中应加载一个祝贺页面；如果没有，请尝试访问WebAdmin控制台。

  3. WebAdmin控制台的默认端口是7080。请在浏览器中输入 https://[address]:7080/ 进入WebAdmin控制台。（如果您在安装过程中更改了WebAdmin控制台端口，请改用该端口。） 请记住，如果服务器就在您当前使用的机器上，[address]可以使用"localhost"。 此时应加载WebAdmin控制台欢迎页面。点击"Log on"链接， 然后使用安装过程中指定的管理员用户名和密码登录。 有关配置的详细信息，请参阅我们的配置指南， 或点击任意页面顶部的"help"链接。

  4. 如果您的服务器使用防火墙，请确保localhost受信任。 例如，在使用IPTables的Linux上，应包含一条 ALLOW INPUT from LO规则。

  5. 如果您的网站和WebAdmin控制台无法访问，请查看错误日志 - [your_install_dir]/logs/error.log
    • 如果与其他服务器应用程序存在TCP端口冲突，应使用可用端口重新安装Web服务器。
      可以使用以下命令查找可用端口：
      netstat -an | grep XXXX
      XXXX是端口号。如果端口可用，该命令将不会产生任何输出。
    • 如果交换目录不可写，您可以为运行Web服务器的用户授予交换目录的写权限， 或手动更改交换目录。交换目录在服务器的XML配置文件 [your_install_dir]/conf/httpd_config.xml 中配置，默认值为/tmp/lshttpd/swap。 请搜索<swappingDir>。

如果您仍然遇到安装问题，请查看我们的 wiki 或在我们的 支持论坛 上发帖。


升级

以下几种情况需要更新或升级服务器：


  • 有新版本可用
  • 从试用许可证升级到正式许可证
  • 升级/降级到其他正式许可证。

升级有多种方式。其中一种方式是再次运行 install.sh，并在提示时选择"Upgrade"。 当前配置将被保留。


版本管理也可以通过WebAdmin控制台完成，位置在 Actions - Version Management。这里会列出所有已安装版本和可用的新版本。 您可以通过点击相应链接安装新版本或在不同版本之间切换。 LSWS还内置了更新代理，会定期检查新版本并发送电子邮件通知。


您可以使用命令行工具lsup.sh升级到最新版本、 强制重新安装，或降级到旧版本。详细用法请参见 [your_install_dir]/admin/misc/lsup.sh --help


LiteSpeed Web Server可以安装多个版本。您可以使用版本管理工具轻松切换版本： [your_install_dir]/admin/misc/mgr_ver.sh。


  • 要切换到已安装的某个版本，例如6.3.5，只需运行 [your_install_dir_current_version]/admin/misc/mgr_ver.sh 6.3.5

  • 要删除某个已安装版本的文件，例如6.3.5，只需运行 [your_install_dir_current_version]/admin/misc/mgr_ver.sh -d 6.3.5

当您升级许可证（例如从试用许可证升级到正式许可证）时， 可以手动将serial.no复制到 [your_install_dir]/conf/目录中，然后重启。