跳转到内容
Web.Casa Docs

安装

Web.Casa 提供多种安装方式，您可以根据环境和需求选择最合适的方案。

最快捷的安装方式。安装脚本会自动检测操作系统、安装依赖并配置 Web.Casa。

支持的发行版（EL9/EL10）：

  • AlmaLinux 9+
  • Rocky Linux 9+
  • CentOS Stream 9+
  • RHEL 9+
  • Oracle Linux 9+
  • Fedora 41+
  • openAnolis 9+
  • openEuler
  • openCloudOS 9+
  • 银河麒麟（Kylin）

  1. 执行安装脚本

    Terminal window
    curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash

  2. 访问面板

    安装完成后，在浏览器中打开：

    http://您的服务器IP:39921

  3. 完成初始设置

    按照页面提示创建管理员账户并配置初始设置。

安装脚本参数

Section titled “安装脚本参数”

一键安装脚本支持以下参数：

参数说明
--port PORT设置自定义面板端口（默认：39921）
--no-caddy跳过 Caddy Web 服务器安装
--no-docker跳过 Docker 用户组设置
--from-source从源码编译而非使用预编译二进制文件
-y、--yes非交互模式运行（自动接受所有默认值）

示例： 使用自定义端口安装，并跳过 Caddy：

Terminal window
curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --port 8080 --no-caddy

升级

Section titled “升级”

将现有安装升级到最新版本：

Terminal window
curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --upgrade

通过源码编译进行升级：

Terminal window
curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --upgrade-from-source

卸载

Section titled “卸载”

移除 Web.Casa 但保留数据：

Terminal window
curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --uninstall

/var/lib/webcasa/ 和 /etc/webcasa/webcasa.env 中的数据和配置文件将被保留。

完全移除 Web.Casa 及所有数据：

Terminal window
curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --purge