nasapsg/psg-amd

NASA PSG Docker镜像文档

概述

本Docker镜像用于在本地环境部署和运行NASA的PSG（Planetary Spectrum Generator）系统。支持通过API接口进行交互，适用于不同处理器架构，包括AMD处理器（大多数非苹果设备）和Apple M1/M2 ARM芯片设备，提供跨平台的PSG系统运行能力。

核心功能

• 跨平台兼容：支持Linux、macOS及Windows系统，适配AMD处理器及Apple ARM架构
• API接口支持：通过本地端口3000提供API访问能力，支持数据交互
• 持久化运行：可配置自动重启参数，确保系统重启后PSG服务持续运行
• 便捷管理：支持通过命令行安装、更新和移除系统包

安装与使用步骤

1. 准备运行环境

根据操作系统安装Docker运行环境：

Linux系统

通过包管理器安装Docker Engine：

bash
# CentOS/RHEL
yum install docker
sudo systemctl start docker

# Debian/Ubuntu
apt-get install docker
sudo systemctl start docker

macOS/Windows系统

安装Rancher Desktop（下载地址：rancherdesktop.io），并按以下配置：

• 容器运行时选择：dockerd (moby)
• 路径配置选择：Automatic
• 禁用Kubernetes
• 建议安装在用户主目录应用文件夹（避免需要管理员权限）

2. 拉取Docker镜像

根据处理器架构执行以下命令拉取镜像：

Apple M1/M2 ARM芯片设备

bash
docker logout
docker pull nasapsg/psg
docker tag nasapsg/psg psg

AMD处理器及其他设备

bash
docker logout
docker pull nasapsg/psg-amd
docker tag nasapsg/psg-amd psg

3. 运行PSG容器

启动PSG容器并映射端口（添加--restart always可实现系统重启后自动运行）：

bash
# 基础运行命令
docker run -d --name psg -p 127.0.0.1:3000:80 psg

# 如需自动重启（推荐）
docker run -d --restart always --name psg -p 127.0.0.1:3000:80 psg

• -d：后台运行容器
• --name psg：指定容器名称为psg
• -p 127.0.0.1:3000:80：将本地3000端口映射到容器80端口
• --restart always：容器退出时自动重启

4. 访问PSG系统

• Web界面：打开浏览器访问 http://localhost:3000
• API接口：通过curl命令调用API（示例）：

  bash
  curl --data-urlencode file@psg_cfg.txt http://localhost:3000/api.php
  

5. 包管理

通过curl命令管理系统包（package为具体包名，小写）：

• 安装包：

  bash
  curl http://localhost:3000/index.php?install=package
  

• 更新包：

  bash
  curl http://localhost:3000/index.php?update=package
  

• 移除包：

  bash
  curl http://localhost:3000/index.php?remove=package
  

注意事项

• 确保Docker服务或Rancher Desktop已启动
• 端口3000未被其他服务占用
• Apple设备安装Rancher Desktop时避免使用/Applications目录，以防需要管理员权限
• 如需详细操作说明，可访问官方文档：[***]