tk120404/node

镜像概述

Node repo镜像是一个专为Node.js生态系统设计的仓库镜像，用于集中存储、管理和分发Node.js相关的包、代码、依赖项或项目资源。该镜像提供标准化的存储结构和访问接口，简化开发团队的资源共享与项目构建流程，确保依赖一致性和开发效率。

核心功能与特性

• 资源存储与管理：支持Node.js npm包、自定义模块、项目代码及构建产物的结构化存储，提供目录分级管理能力。
• 版本控制：内置版本标记与管理机制，支持多版本资源并行存储，可追溯历史版本及回滚操作。
• 依赖分发：作为统一资源入口，为开发/生产环境提供依赖获取服务，确保项目依赖版本一致性。
• 轻量级设计：基于Alpine或精简Debian基础镜像构建，镜像体积小，启动速度快，资源占用低。
• 数据持久化：支持通过卷挂载实现仓库数据持久化，避免容器重启或重建导致的数据丢失。
• 访问控制：可选启用基础认证机制，限制仓库访问权限，保障资源安全性。

使用场景

• 团队协作开发：开发团队内部共享私有Node.js模块、工具函数或通用代码片段，减少重复开发。
• 项目依赖管理：集中托管项目特定依赖包，解决第三方npm仓库访问限制或网络不稳定问题。
• CI/CD流程集成：作为CI/CD流水线中的资源节点，支持构建过程中的依赖拉取或产物推送（如构建后的Node.js应用包）。
• 离线开发环境：在无网络或网络受限场景下，提供本地Node.js依赖仓库，满足项目离线构建需求。

使用方法与配置说明### 基础部署（docker run）

通过以下命令快速启动仓库容器，默认配置下可直接使用基础仓库功能：

bash
docker run -d \
  --name node-repo \
  -p 8080:8080 \
  -v /host/path/to/repo:/data/repo \
  docker.xuanyuan.run/node-repo:latest

参数说明：

• -d：后台运行容器
• --name node-repo：指定容器名称（自定义）
• -p 8080:8080：映射容器8080端口到主机（可根据需求修改主机端口）
• -v /host/path/to/repo:/data/repo：挂载主机目录到容器内仓库根目录（需替换为实际主机路径）

环境变量配置

通过环境变量自定义仓库行为，常用配置项如下：

示例：启用认证的仓库部署

bash
docker run -d \
  --name secure-node-repo \
  -p 8081:8080 \
  -v /host/secure-repo:/data/repo \
  -e AUTH_ENABLED=true \
  -e AUTH_USER=dev-team \
  -e AUTH_PASSWORD=SecurePass123! \
  -e LOG_LEVEL=debug \
  docker.xuanyuan.run/node-repo:latest

仓库访问与使用

1. 基础访问

容器启动后，通过以下方式访问仓库服务：

• 浏览器访问：http://<主机IP>:<映射端口>（查看仓库目录结构或资源列表）
• 命令行访问：通过curl或wget获取资源，如 curl http://localhost:8080/packages/react/18.2.0.tgz

2. 作为npm仓库使用

若需将仓库配置为npm源，可通过以下命令临时或永久设置：

bash
# 临时使用仓库（当前终端会话）
npm config set registry http://localhost:8080

# 项目级配置（仅当前项目生效）
npm config set registry http://localhost:8080 --location project

# 安装依赖示例
npm install react --registry http://localhost:8080

3. 资源上传（需启用认证）

通过基础认证上传资源（示例使用curl）：

bash
curl -u dev-team:SecurePass123! -X PUT \
  -T ./local-package.tgz \
  http://localhost:8081/packages/local-package/1.0.0.tgz

注意事项

• 生产环境建议通过-v参数挂载主机目录或使用Docker Volume，确保仓库数据持久化。
• 高并发场景下，可结合Nginx等反向代理实现负载均衡和请求缓存。
• 敏感环境中建议启用认证并定期更新访问凭证，避免未授权访问。