如何在内网环境（无外网）下完整地使用Composer？（离线镜像方案）

技术教程
2025-12-18 15:01:02

内网使用Composer需构建本地离线镜像源：先用Satis在联网机生成静态包仓库，再同步至内网服务器，最后配置Composer指向该源；支持私有包dist方式引入及增量更新。

如何在内网环境（无外网）下完整地使用composer？（离线镜像方案）

在内网环境使用 Composer，核心是把所有依赖包和元数据提前下载好，构建一个本地可访问的离线镜像源。不需要外网，但需要一台能联网的机器做前期准备，再把资源同步到内网服务器或开发机。

一、用 Packagist 镜像站生成离线包（推荐 Satis）

Satis 是官方推荐的轻量级静态包仓库生成工具，适合内网部署。它不依赖数据库，只生成 JSON 和 ZIP 文件，Nginx/Apache 直接托管即可。

在有网机器上安装 Satis：composer create-project composer/satis --stability=stable

编写 satis.json，明确指定要镜像的包和版本（避免全量同步，节省空间）：

{
  "name": "internal/packagist",
  "homepage": "http://packages.internal",
  "repositories": [
    { "type": "composer", "url": "https://packagist.org" }
  ],
  "require-all": false,
  "require": {
    "monolog/monolog": "^2.0",
    "guzzlehttp/guzzle": "^7.0"
  },
  "archive": {
    "directory": "dist",
    "format": "zip",
    "skip-dev": true
  }
}

运行 php bin/satis build satis.json web/，生成完整静态站点（含 packages.json、压缩包、autoload 信息）
把整个 web/ 目录拷贝到内网服务器，用 Nginx 指向该目录根路径（确保能通过 http://192.168.10.100 访问到 packages.json）

二、配置 Composer 使用本地镜像

内网机器无需联网，只需让 Composer 知道去哪里找包。有两种常用方式：

全局配置镜像源（推荐）：
composer config -g repos.packagist '{"type":"composer","url":"http://192.168.10.100"}'
这会覆盖默认 packagist.org，所有项目自动走内网源
项目级配置（更灵活）：
在项目根目录运行：
composer config repos.packagist '{"type":"composer","url":"http://192.168.10.100"}'
会在 composer.json 中添加 repositories 字段，仅当前项目生效

三、处理私有包与 Git 依赖（无 SSH/Git 协议时）

如果项目依赖内网 GitLab 或私有仓库，而内网不能走 git+ssh 或 https 协议，可转为 dist 方式：

吐司AI

超多功能的免费在线生图网站！拥有全网更齐全的模型库，0门槛使用！

322 查看详情吐司AI

将私有包打成 ZIP，放在内网 Web 可访问路径下（如 http://192.168.10.100/dist/mycompany/core.zip）

在 composer.json 中声明为 package 类型：

"repositories": [
      {
        "type": "package",
        "package": {
          "name": "mycompany/core",
          "version": "1.2.0",
          "dist": {
            "url": "http://192.168.10.100/dist/mycompany/core.zip",
            "type": "zip"
          },
          "autoload": { "psr-4": { "MyCompany\": "src/" } }
        }
      }
    ]