1. 理解工作原理:弄清楚 Cydia/Sileo 是如何与你的网站交互的。
  2. 准备服务器:搭建一个能提供必要服务的网络服务器。
  3. 创建必要的文件:编写 Packages 文件、Release 文件、图标等。
  4. 配置 Web 服务器:让服务器能正确地提供这些文件。
  5. 在设备上添加源:让用户能找到并安装你的插件。

下面我将为你提供一个详细、分步的搭建指南。

cydia插件网站搭建
(图片来源网络,侵删)

第一步:理解核心概念

在开始之前,你必须明白 Cydia/Sileo 是如何工作的,它不像普通的网页浏览。

  1. APT (Advanced Package Tool):Cydia 和 Sileo 的底层都是 Debian/Ubuntu 系统的包管理器 APT,你的网站必须像一个“软件源仓库”(Repository)一样工作。
  2. Packages 文件:这是你网站的核心,它是一个纯文本文件,列出了你仓库中每一个软件包的所有信息,包括名称、版本、描述、依赖关系、下载链接等,Cydia/Sileo 会下载并解析这个文件来显示你的插件列表。
  3. Release 文件:这是一个用于验证 Packages 文件完整性和真实性的文件,它包含了 Packages 文件的哈希值和签名。这是现代源(尤其是 Sileo)强烈推荐甚至必需的,可以防止你的源被篡改。
  4. Release.gpg / InRelease 文件Release 文件的签名版本,你需要一个 GPG 密钥来对 Packages 文件进行签名,然后将公钥分发给用户,让他们可以验证你的源。
  5. 图标和截图:为了让你的插件在源列表里看起来更专业,你需要提供 icon@2x.png (高分辨率图标) 和 screenshot.png (截图)。

第二步:准备服务器环境

你可以使用任何能运行 Web 服务器和 PHP 的虚拟主机或 VPS(Virtual Private Server),这里以最常用的 Nginx + PHP 为例。

  1. 购买 VPS/虚拟主机

    • VPS (推荐):如 Vultr, DigitalOcean, Linode, 阿里云, 腾讯云等,你将获得更高的控制权。
    • 虚拟主机:一些主机商提供支持 PHP 的空间,但可能需要你手动配置一些东西。
  2. 安装环境

    cydia插件网站搭建
    (图片来源网络,侵删)
    • 如果你用的是 VPS(以 Ubuntu 为例),SSH 登录后执行:

      # 更新系统
      sudo apt update && sudo apt upgrade -y
      # 安装 Nginx 和 PHP
      sudo apt install nginx php-fpm php-zip -y
    • 如果你用的是虚拟主机,通常这些环境已经安装好了。

  3. 配置网站

    • 为你的源创建一个网站目录,/var/www/my-repo

      cydia插件网站搭建
      (图片来源网络,侵删)
    • 在 Nginx 中配置一个新的站点,指向这个目录,配置文件通常在 /etc/nginx/sites-available/ 目录下。

    • 一个简单的 Nginx 配置示例 (my-repo):

      server {
          listen 80;
          server_name repo.yourdomain.com; # 替换成你的域名
          root /var/www/my-repo;
          index index.php index.html;
          location / {
              try_files $uri $uri/ =404;
          }
          location ~ \.php$ {
              include snippets/fastcgi-php.conf;
              fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # 注意版本号,可能是 php7.x-fpm.sock
          }
      }
    • 启用这个站点并重启 Nginx:

      sudo ln -s /etc/nginx/sites-available/my-repo /etc/nginx/sites-enabled/
      sudo nginx -t
      sudo systemctl restart nginx

第三步:创建源文件

这是最关键的一步,我们需要一个工具来自动生成 PackagesRelease 文件,最常用的是 apt-mimic

  1. 安装 apt-mimic: 在你的服务器上安装它(通常需要 Python 3):

    sudo apt install python3-pip
    pip3 install apt-mimic
  2. 创建仓库结构: 在你的网站根目录 /var/www/my-repo 下,创建一个 debs 文件夹,用来存放你的 .deb 安装包。

    sudo mkdir -p /var/www/my-repo/debs
  3. 上传 .deb 文件: 将你开发的或收集的 .deb 文件上传到 /var/www/my-repo/debs/ 目录里。

  4. 生成 PackagesRelease 文件: 运行 apt-mimic 命令,它会扫描 debs 目录,生成所需的文件。

    # 进入你的网站根目录
    cd /var/www/my-repo
    # 运行 apt-mimic
    # -r . 表示根目录
    # -a arm64 表示架构,iOS 设备通常是 arm64
    # -o . 表示输出到当前目录
    apt-mimic -r . -a arm64 -o .

    执行成功后,你的网站根目录下会出现以下文件:

    • Packages:核心的包列表文件。
    • Packages.gzPackages 文件的压缩版本,用于节省带宽。
    • Release:包含了 Packages 文件的哈希值。
    • Release.gpgRelease 文件的 GPG 签名。
  5. 创建 GPG 密钥(如果需要签名): 如果你想让你的源更安全(强烈推荐),你需要创建一个 GPG 密钥对。

    gpg --full-generate-key

    按照提示操作,选择 RSA (sign only),密钥长度 4096,没有过期时间即可,记住你设置的密码。

    创建完成后,列出密钥找到你的 Key ID:

    gpg --list-keys

    输出类似 pub rsa4096 2025-10-27 [SC] [expires: 2025-10-27] ABC12345...ABC12345... 就是你的 Key ID。

    用这个密钥来签名 Release 文件(apt-mimic 通常会自动处理,但如果没自动,可以手动签名):

    gpg --default-key ABC12345... --armor --sign --detach-sigma Release

    这会生成 Release.gpg 文件。

  6. 添加图标和截图: 在你的网站根目录下,创建以下文件(这是 Cydia/Sileo 的标准约定):

    • icon@2x.png:建议尺寸 120x120 像素。
    • screenshot.png:建议尺寸 320x480 像素或更大。

第四步:在 Cydia/Sileo 中添加源

现在你的网站已经是一个功能完整的软件源了!最后一步是告诉用户如何添加它。

  1. 获取源的 URL: 你的源地址就是你的网站域名,https://repo.yourdomain.com

  2. 添加源的步骤

    • 在 Sileo 中

      1. 打开 Sileo。
      2. 点击底部的 "Sources" (来源) 标签。
      3. 点击右上角的 "+" 号。
      4. 输入你的源地址 https://repo.yourdomain.com,然后点击 "Add" (添加)。
      5. Sileo 会自动下载并解析 Packages 文件,稍等片刻后,你就能在 "Updates" (更新) 或 "Installed" (已安装) 标签页下看到你的插件了。
    • 在 Cydia 中

      1. 打开 Cydia。
      2. 点击底部的 "Manage" (管理) 标签。
      3. 点击 "Sources" (来源)。
      4. 点击右上角的 "Edit" (编辑),然后点击左上角的 "+" 号。
      5. 输入你的源地址 https://repo.yourdomain.com,然后点击 "Add" (添加)。
      6. Cydia 会提示你添加源的来源,点击 "Add Anyway" (无论如何都添加)。
      7. 等待 Cydia 刷新源,完成后你就可以在 "Changes" (变更) 或 "Installed" (已安装) 标签页下找到你的插件。

第五步:维护和更新

你的源不是一次性的,需要持续维护。

  1. 添加新插件: 当你有新的 .deb 文件时,只需将其上传到 /var/www/my-repo/debs/ 目录。 再次运行 apt-mimic 命令来更新 PackagesRelease 文件:

    cd /var/www/my-repo
    apt-mimic -r . -a arm64 -o .

    Cydia/Sileo 在下次检查更新时就会自动发现新版本。

  2. 解决依赖问题: 如果你的插件依赖其他软件包(MobileSubstrate, Theos, libsubstrate 等),你必须在 Packages 文件中声明这些依赖。apt-mimic 通常会自动处理,如果用户安装时提示依赖问题,说明你的 .deb 包在打包时没有正确声明依赖。

  3. HTTPS 证书强烈建议 为你的域名配置 HTTPS(使用 Let's Encrypt 的免费证书),Cydia/Sileo 在访问不安全的 HTTP 源时会发出警告,影响用户体验。


总结与注意事项

  • Sileo vs Cydia:虽然我们习惯叫 Cydia 源,但现在新源都应该优先考虑 Sileo 的标准,特别是 GPG 签名,Sileo 的用户体验和安全性都更好。
  • 法律风险:确保你上传的插件不包含盗版软件、付费破解内容或有版权争议的材料,这可能会导致你的源被屏蔽,甚至带来法律风险。
  • 服务器稳定性:如果你的源服务器不稳定,用户将无法安装或更新你的插件,这会严重影响口碑。
  • 社区支持:加入一些 iOS 越狱相关的开发者社区(如 Discord 频道、Telegram 群),你可以在那里获得帮助和反馈。

搭建自己的 Cydia/Sileo 源是一个非常有成就感的项目,它不仅能让你分享自己的作品,也能让你深入了解 iOS 越狱生态的底层运作机制,祝你成功!