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

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

在内网环境使用 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 方式：

标签： php js git json composer apache nginx 工具 proxy gitlab 镜像源