信创 - tag - 沐木https://oldletter.cn/tags/%E4%BF%A1%E5%88%9B/信创 - tag - 沐木Hugo -- gohugo.iozh-cnWed, 20 Aug 2025 00:00:00 +0000信创实战：Nacos 在申威 3231 上的 RocksDB JNI 适配https://oldletter.cn/posts/xinchuang-01-nacos/Sun, 01 Dec 2024 00:00:00 +0000mumuhttps://oldletter.cn/posts/xinchuang-01-nacos/

系列：信创国产化适配 | 作者：lin | 更新：2026-07-18

先把适配对象和结果讲清楚

本文详细记录的源码修改、汇编适配、JNI 编译和 JAR 改造，全部发生在申威 3231 的 SW64 环境。下文的工具链、汇编和构建命令均以 SW64 为目标，不包含龙芯 LoongArch 的编译过程。

rocksdbjni 8.8.1 适配完成后，申威 3231 和 HX8000 均已正常运行。

平台 原始情况 最终结果
龙芯 LoongArch 当前已有可用支持 只作现状对照，不套用申威编译过程
申威 3231 官方 8.8.1 JAR 缺少 SW64 原生库 完成 SW64 汇编、编译和 JAR 改造后运行通过
HX8000 按现场环境单独验证 运行通过

原始故障仍要从 Nacos 的实际依赖看起。Nacos 经 JRaft 引入 rocksdbjni 8.8.1，官方通用 JAR 没有携带 SW64 原生库。申威 3231 的适配同时处理了 SWJDK、SW64 ABI、汇编实现、编译器、系统动态库和 Java 资源命名。

截至 2026-07-15，几个常见 Nacos 版本的依赖关系如下：

]]>信创实战：Dockerfile 信创基础镜像构建https://oldletter.cn/posts/xinchuang-02-dockerfile/Sat, 15 Feb 2025 00:00:00 +0000mumuhttps://oldletter.cn/posts/xinchuang-02-dockerfile/

系列：信创国产化适配 | 作者：lin | 日期：2026-05-15

一、背景与问题

1.1 为什么信创环境需要自定义 Docker 镜像

在信创国产化落地过程中，Docker 容器化部署是标配。但直接使用官方镜像会遇到以下问题：

  1. 架构不匹配：官方 Docker Hub 上的 OpenJDK 镜像主要提供 amd64 和 aarch64，缺少申威 sw64、龙芯 loongarch64 等国产架构
  2. OS 不兼容：信创环境通常要求使用国产操作系统（麒麟、统信），而官方镜像基于 Debian/Ubuntu
  3. 安全合规：信创项目通常要求使用经过安全审计的基础镜像，不能直接拉取公网镜像
  4. 定制需求：需要预装特定工具、配置国内镜像源、设置时区和 Locale 等

1.2 基础镜像选型对比

镜像 体积 包管理 国产 CPU 支持 适用场景
Alpine 3.20 ~5MB apk 仅 x86/arm64（申威/龙芯需基于国产OS） 追求极致精简
Ubuntu 22.04 ~77MB apt 较好 需要 glibc 环境
麒麟 V10 ~200MB yum/dnf 原生支持 信创验收要求
统信 UOS ~200MB apt 原生支持 信创验收要求
Amazon Corretto 基于 Alpine apk 官方多架构 生产推荐
镜像选型建议
鲲鹏 ARM64：直接使用 Amazon Corretto 官方多架构镜像。申威 SW64 / 龙芯 LoongArch：Alpine 官方不支持这两种架构，必须基于国产 OS（龙芯开源系统、统信 UOS、麒麟 V10 等）自行构建基础镜像。信创验收场景：基于麒麟/统信构建，满足安全审查要求。所有国产 CPU 环境都建议提前规划内部镜像仓库。

二、Amazon Corretto 8 JDK 镜像构建（Alpine 3.20）

2.1 完整 Dockerfile

# ============================================================
# 信创基础镜像：Amazon Corretto 8 JDK (Alpine 3.20)
# 支持架构：x86_64, aarch64（鲲鹏）
# 适用场景：Java 微服务基础运行环境
# ============================================================

FROM alpine:3.20

# ============================================================
# 镜像元信息
# ============================================================
LABEL maintainer="lin" \
      description="Amazon Corretto 8 JDK for xinchuang" \
      version="8u422" \
      architecture.multiarch="true"

# ============================================================
# 环境变量
# ============================================================
# Corretto 版本（可通过构建参数覆盖）
ARG CORRETTO_VERSION=8.422.05.1
ARG CORRETTO_SHA256_AMD64=a7b7e2f8c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0
ARG CORRETTO_SHA256_AARCH64=b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9

ENV JAVA_HOME=/usr/lib/jvm/java-1.8.0-amazon-corretto \
    PATH="/usr/lib/jvm/java-1.8.0-amazon-corretto/bin:${PATH}" \
    LANG=en_US.UTF-8 \
    LC_ALL=en_US.UTF-8 \
    TZ=Asia/Shanghai \
    # JVM 默认参数（可通过环境变量覆盖）
    JAVA_OPTS="-XX:+UseG1GC -XX:MaxGCPauseMillis=200 -Djava.security.egd=file:/dev/./urandom"

# ============================================================
# 安装基础依赖 + 配置国内镜像源
# ============================================================
# 使用阿里云镜像源加速（信创环境通常无法直接访问 dl-cdn.alpinelinux.org）
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories && \
    apk add --no-cache \
        bash \
        curl \
        wget \
        tzdata \
        ca-certificates \
        fontconfig \
        ttf-dejavu \
        busybox-extras \
        procps \
        gzip \
        tar \
        zip \
        unzip \
    && rm -rf /var/cache/apk/*

# ============================================================
# 时区配置
# ============================================================
RUN ln -sf /usr/share/zoneinfo/${TZ} /etc/localtime && \
    echo "${TZ}" > /etc/timezone

# ============================================================
# Locale 配置
# ============================================================
ENV LANG=en_US.UTF-8 \
    LANGUAGE=en_US:en \
    LC_ALL=en_US.UTF-8

# ============================================================
# 安装 Amazon Corretto 8 JDK
# ============================================================
RUN ARCH=$(uname -m) && \
    case "${ARCH}" in \
        x86_64)  CORRETTO_ARCH="x64" ;; \
        aarch64) CORRETTO_ARCH="aarch64" ;; \
        *)       echo "Unsupported architecture: ${ARCH}" && exit 1 ;; \
    esac && \
    wget -q -O /tmp/corretto.tar.gz \
        "https://corretto.aws/downloads/latest/amazon-corretto-${CORRETTO_VERSION}-linux-${CORRETTO_ARCH}-jdk.tar.gz" && \
    mkdir -p /usr/lib/jvm && \
    tar -xzf /tmp/corretto.tar.gz -C /usr/lib/jvm && \
    ln -sf /usr/lib/jvm/amazon-corretto-${CORRETTO_VERSION}-linux-${CORRETTO_ARCH} \
           /usr/lib/jvm/java-1.8.0-amazon-corretto && \
    rm -f /tmp/corretto.tar.gz && \
    java -version

# ============================================================
# 内置健康检查脚本：java-info
# ============================================================
RUN cat > /usr/local/bin/java-info << 'SCRIPT' && chmod +x /usr/local/bin/java-info
#!/bin/bash
echo "========================================="
echo "  Java Environment Info"
echo "========================================="
echo ""
echo "📦 JDK Version:"
java -version 2>&1
echo ""
echo "📁 JAVA_HOME: ${JAVA_HOME}"
echo "🏗️  Architecture: $(uname -m)"
echo "🐧 OS: $(cat /etc/os-release 2>/dev/null | grep PRETTY_NAME | cut -d= -f2 | tr -d '"')"
echo "🕐 Timezone: $(cat /etc/timezone 2>/dev/null || echo 'not set')"
echo ""
echo "💾 Memory:"
free -h 2>/dev/null || echo "  (free command not available)"
echo ""
echo "🔧 JVM System Properties (key ones):"
java -XshowSettings:all 2>&1 | grep -E "(java.home|os.arch|os.name|file.encoding|user.timezone)" | sed 's/^/  /'
echo ""
echo "========================================="
SCRIPT

WORKDIR /app
CMD ["bash"]

2.2 构建与使用

# 构建镜像（单架构）
docker build -t xinchuang/corretto8-jdk:8u422-alpine3.20 .

# 验证
docker run --rm xinchuang/corretto8-jdk:8u422-alpine3.20 java-info

三、Docker Buildx 多架构构建

3.1 Buildx 基础概念

Docker Buildx 是 Docker 的扩展构建工具，支持一次构建同时生成多架构镜像。在信创场景下，因此可以用一条命令同时构建 x86_64 和 ARM64 的镜像。

]]>信创实战：Java 服务管理脚本（生产级）https://oldletter.cn/posts/xinchuang-03-java-service-script/Thu, 10 Apr 2025 00:00:00 +0000mumuhttps://oldletter.cn/posts/xinchuang-03-java-service-script/

系列：信创国产化适配 | 作者：lin | 日期：2026-05-15

一、背景与问题

1.1 为什么需要专业的 Java 服务管理脚本

在很多项目中，Java 服务的启动方式还停留在：

# ❌ 野蛮启动方式
nohup java -jar app.jar > app.log 2>&1 &
echo $! > app.pid

这种方式存在诸多问题：

问题 影响
进程意外退出后无法自动重启 服务不可用，需人工介入
停止服务直接 kill -9 数据丢失、连接池未关闭
没有 PID 管理 重复启动、僵尸进程
日志输出到 nohup.out 日志无法轮转，磁盘被打满
无法集成 systemd 不符合 Linux 服务管理规范
每次部署手动操作 容易出错，效率低下

1.2 设计目标

我们要实现一个生产级的 Java 服务管理脚本，满足以下要求：

  1. 自动检测 Java：JAVA_HOME → 常见安装路径 → PATH，三级探测
  2. 自动识别 jar：无需硬编码 jar 文件名
  3. 首次部署兼容：自动创建目录结构、移动配置文件
  4. systemd 集成：一键安装/卸载系统服务
  5. 受控停机：发送 SIGTERM 并等待，超时后再由策略决定是否发送 SIGKILL
  6. PID 文件管理：防止重复启动，精确控制进程

二、JVM 堆内存分配公式

在配置 JAVA_OPTS 之前，理解 JVM 内存分配至关重要：

]]>信创实战：信创数据库全景图https://oldletter.cn/posts/xinchuang-04-database-guide/Sun, 15 Jun 2025 00:00:00 +0000mumuhttps://oldletter.cn/posts/xinchuang-04-database-guide/

信创进入深水区，数据库选型不再是"能不能用"的问题，而是"怎么选、选了怎么落地"的问题。本文从技术路线出发，梳理主流信创数据库的产品矩阵，给出面向架构师的选型决策框架。

一、引言：信创进入深水区，数据库选型是关键决策

2025-2026 年，信创产业已从"试点验证"迈向"规模化落地"。在这一阶段，数据库作为基础软件的核心组件，其选型决策直接影响：

  • 系统架构的天花板：选错了路线，后续迁移成本可能是天文数字；
  • 国产 CPU 的适配深度：不同数据库对飞腾、鲲鹏、海光、龙芯、申威的支持程度差异显著；
  • 业务连续性保障：安全可靠测评等级直接关系到能否进入关键行业采购目录；
  • 团队的技术栈投入：一条技术路线背后是一整套人才培养和运维体系。

对架构师而言，理解国产数据库的技术路线分类，比记住某个产品的版本号更重要。路线决定了基因，基因决定了上限。

二、核心认知：国产数据库的四条技术路线

国产数据库的发展路径，大致可以归结为四条技术路线。每条路线有不同的技术基因、生态位和适用场景。

2.1 完全自研路线

代表产品：达梦（DM）、崖山（YashanDB）、OceanBase、TiDB、虚谷

技术特征：

  • 内核完全自研，不依赖任何开源数据库内核
  • 拥有完整的存储引擎、查询优化器、事务管理器的自主知识产权
  • SQL 方言可能与主流数据库存在差异，但近年来普遍加强了兼容性

优势：

  • 知识产权清晰，不存在开源协议争议
  • 内核可控，针对国产硬件的深度优化空间上限
  • 安全可靠测评中"自主可控"维度得分更高
  • 长期来看不受上游开源项目路线变更的影响

劣势：

  • 生态工具链需要从零建设或自建适配层
  • 学习曲线相对陡峭，DBA 迁移成本较高
  • 部分产品的社区活跃度和第三方文档不如开源路线丰富

适用场景：对自主可控要求极高的场景（军工、核心政务系统），以及需要深度定制内核的场景。

2.2 PostgreSQL 二次开发路线

代表产品：金仓（KingbaseES）、瀚高（HighGo DB）、大云海山（中国移动）

技术特征：

  • 基于 PostgreSQL 内核进行深度二次开发
  • 保留了 PostgreSQL 的 SQL 语法、扩展机制和工具链兼容性
  • 在此基础上增加国产 CPU 适配、安全增强、高可用扩展等能力

优势：

  • 继承了 PostgreSQL 成熟的 SQL 标准支持和扩展生态
  • 迁移成本相对较低，Oracle/PG DBA 可快速上手
  • 社区工具链（pg_dump、pgAdmin 等）可直接复用
  • 经过多年打磨，稳定性和兼容性已有大量生产验证

劣势：

  • 受 PostgreSQL 上游版本演进影响，大版本升级需要同步跟进
  • 深度定制可能导致与上游 PG 的兼容性逐渐偏离
  • 在极端性能场景下，二次开发层可能引入额外开销

适用场景：已有 PostgreSQL 或 Oracle 技术栈的团队，需要平滑迁移的场景；对 SQL 标准兼容性要求较高的 OLTP 业务。

]]>Maven 国内源配置指南（2026 版）https://oldletter.cn/posts/java-02-maven/Wed, 24 Nov 2021 00:00:00 +0000mumuhttps://oldletter.cn/posts/java-02-maven/

📅 2026-05-15 | 🏷️ Maven, Gradle, 信创, DevOps | 📖 阅读约 12 分钟

前言

“Could not resolve dependencies”，这大概是每个 Java 开发者在国内网络环境下更不想看到的错误。

Maven Central 在国内访问速度慢、不稳定，尤其在企业内网和信创环境下，配置国内镜像源几乎是项目初始化的第一步。但你真的会配吗？镜像优先级怎么算？私服和镜像怎么共存？Gradle 的配置和 Maven 有什么不同？

这篇文章给你一个完整的、可直接复制粘贴的配置方案，覆盖 Maven、Gradle、私服、代理、信创环境，2026 年当前公开版。

一、为什么需要国内镜像

Maven Central（https://repo.maven.apache.org/maven2）物理上在美国，国内访问存在以下问题：

  1. 延迟高：HTTPS 握手 + TCP 往返，单次请求 500ms-2s
  2. 不稳定：国际链路抖动，下载大文件容易中断
  3. 带宽受限：高峰期下载速度可能只有几十 KB/s
  4. 安全合规：信创/政企环境不允许直接访问外网

国内镜像源同步了 Maven Central 的所有包，物理上在国内，访问速度提升 10-100 倍。

Maven 依赖解析机制

Maven 的依赖解析遵循下限路径优先原则。当同一个依赖存在多个版本时，Maven 会在依赖树中选择深度更浅（路径下限）的那个版本。如果深度相同，则按 POM 中声明的顺序选择第一个。

形式化地说，对于依赖树中的节点 D，其解析版本为所有候选版本中深度下限的那个。因此直接声明的依赖优先级高于传递依赖。

二、Maven 配置

2.1 settings.xml 完整配置

将以下内容保存到 ~/.m2/settings.xml（全局配置）或 $MAVEN_HOME/conf/settings.xml（安装级别）：

]]>信创项目实战总结：从申威龙芯到数据库三大件与容器化部署https://oldletter.cn/posts/xinchuang-05-project-summary/Wed, 20 Aug 2025 00:00:00 +0000mumuhttps://oldletter.cn/posts/xinchuang-05-project-summary/

作者：林 | 系列：信创实战 | 适合读者：信创项目实施者、Java 后端/架构师、运维工程师

一、背景：为什么要做信创

信创（信息技术应用创新）的核心目标是自主可控。从芯片到操作系统，从数据库到中间件，逐步替换国外技术栈，降低供应链风险。

一个典型的信创项目涉及：

  • 芯片：申威、龙芯、飞腾、鲲鹏、海光、兆芯
  • 操作系统：麒麟（银河麒麟/中标麒麟）、统信 UOS、欧拉
  • 数据库：达梦、人大金仓、神通
  • 中间件：东方通 TongWeb、宝兰德 BES
  • 办公软件：WPS、永中 Office
  • 可信计算：国密算法（SM2/SM3/SM4）、可信平台模块
  • 容器化：Docker 适配、镜像编译

本文是实际项目中的踩坑总结，重点覆盖申威、龙芯、数据库三大件和容器化部署。

二、国产 CPU 处理器选型

2.1 六大国产 CPU 对比

厂商 指令集 代表型号 定位 生态成熟度
申威 SW64（自主） SW1621、SW3231、HX 系列 特种/超算/信创 ⭐⭐
龙芯 LoongArch（自主） 3A5000、3C5000、3A6000、3C6000 桌面/服务器 ⭐⭐⭐
飞腾 ARMv8/AArch64（授权） FT-2000、S2500 桌面/服务器 ⭐⭐⭐⭐
鲲鹏 ARMv8/AArch64（授权） 鲲鹏 920 服务器 ⭐⭐⭐⭐
海光 x86（授权） 海光 7000、海光 5000 服务器 ⭐⭐⭐⭐⭐
兆芯 x86（授权） 开胜 KH-40000 桌面/服务器 ⭐⭐⭐⭐

⚠️ 注意：海光和兆芯的 x86 授权有争议（AMD/VIA 授权），严格意义上不算"完全自主"。部分信创项目不接受 x86 路线。

]]>