Jekyll2026-11-06T06:36:19+00:00https://natsurainko.github.io/feed.xmlnatsurainkoTechnical NotesnatsurainkoHello World Test2026-11-06T00:00:00+00:002026-11-06T00:00:00+00:00https://natsurainko.github.io/2026/11/06/hello-world
public class HelloWorld
{
    public static void Main()
    {
        Console.WriteLine("Hello, world!");
    }
}
]]>natsurainkoConnectX 服务端部署指南2025-03-17T22:43:37+00:002025-03-17T22:43:37+00:00https://natsurainko.github.io/2025/03/17/connectx-server-deploymentConnectX 是什么

ConnectX 是一个跨平台的 Minecraft P2P 在线多人库，支持异地跨网联机，采用 C# 开发，使用高性能套接字实现出色的转发性能，由 Zerotier SDK 实现 P2P 功能。 Github 仓库地址：ConnectX

ConnectX 服务端部署指南

前置条件

  • 一台装有 Visual Studio，且安装了 .NET 桌面开发 工作负荷，用于编译 ConnectX.Server 以及 ConnectX.Relay 的可执行文件
  • 一台拥有公网的服务器，用于部署 ConnectX.Server 以及 ConnectX.Relay 服务

服务器系统推荐使用 Ubuntu 22.04 或者是 Windows Server，因为后续需要安装 .NET 9 运行时（本人在 Ubuntu 24.04 上安装 .NET 9 没成功..）

编译可执行文件

  1. Clone 本项目仓库到本地

  2. 使用 Visual Studio 打开本项目

  3. 编辑项目文件（可选）

如果你不想为 ConnectX.Server 另外单独配置 Sql 数据库服务，你可以将 Program.cs 文件中的以下几行代码

services.AddDbContext<RoomOpsHistoryContext>(o =>
    o.UseSqlServer(connectionString, b => b.MigrationsAssembly("ConnectX.Server")));

替换为

services.AddDbContext<RoomOpsHistoryContext>(o =>
    o.UseSqlite(connectionString, b => b.MigrationsAssembly("ConnectX.Server")));

它会让你的 ConnectX.Server 运行时使用 Sqlite 本地数据库

  1. 发布项目 ConnectX.Server 以及 ConnectX.Relay

请根据你的服务器系统选择目标平台是 linux-x64 还是 win-x64 或者其他，部署模式选择 依赖框架 ，文件发布选项启用 生成单个文件

重要： 现阶段请不要为 ConnectX.Server 以及 ConnectX.Relay 启用 PublishAOT ，这可能会导致运行不正常

部署 Zerotier 服务

ConnectX.Server 需要 Zerotier 控制器 前置服务

  1. 安装 Zerotier

前往 Download Zerotier，选择适合你的服务器系统的版本安装

  1. 配置 Zerotier

设置 Zerotier 开机启动，如果你是 linux ，请输入 systemctl enable zerotier-one ，Windows 安装完后默认可以在任务管理器里面看到开机启动

验证 Zerotier 是否启动成功，在终端中输入 zerotier-cli info ，
如果出现 200 info 495b749d3c 1.14.2 TUNNELED 或者是 200 info 495b749d3c 1.14.2 ONLINE 的字样则说明成功

  1. 获取 Zerotier 服务信息

linux 下 Zerotier 的数据文件夹在 /var/lib/zerotier-one 目录下，
Windows 下 Zerotier 的数据文件夹在 C:\ProgramData\ZeroTier\One 目录下

其中 authtoken.secret 储存的是 Zerotier 控制器的访问 Token ，请记下它
zerotier-one.port 储存的是 Zerotier 控制器的访问访问端口，默认为 9993 ，请记下它

  1. 部署 Zerotier Moon 卫星级服务器 （可选）

请参考这篇文章：https://www.wnark.com/archives/152.html

重要： 暂不清楚部署 Moon 卫星级服务器到底能不能对 P2P 连接起到正向作用，需要验证

  1. 放行 Zerotier 控制器端口 (Tcp/Udp)

部署 ConnectX.Server 以及 ConnectX.Relay 服务

  1. 将先前发布的可执行文件及其依赖 Dll 上传到服务器，连同发布目录下的 appsettings.json 一起上传

  2. 配置 ConnectX.Server

修改 Server:ListenAddress 为 0.0.0.0 修改 Server:ServerId 为一个 Guid 字符串，例 ddad03b9-d122-421d-add7-1d09e65b4295 修改 ZeroTier:EndPoint 为 http://127.0.0.1:{port} ，其中 {port} 为之前你记下的 Zerotier 控制器服务的端口
修改 ZeroTier:Token 为之前你记下的 Zerotier 控制器服务的访问 Token
修改 ConnectionStrings:Default 为你的 Sql 数据库，如果你在前面修改代码使用了 Sqlite ，请将该项写入为 Data Source=Sqlite.db ，运行后会自动生成 Sqlite.db 文件作为数据库

  1. 配置 ConnectX.Relay

修改 RelayServer:ListenAddress 为 0.0.0.0
修改 RelayServer:PublicListenAddress 为运行 ConnectX.Relay 的服务器的公网地址
修改 Server:ListenPort 为上面 ConnectX.Server 的监听端口，默认为 3535
修改 Server:ServerId 为上面 ConnectX.Server 的 ServerId
如果你将 ConnectX.Relay 和 ConnectX.Server 放在一个服务器上运行，则保留原有配置 127.0.0.1 ，否则请修改 Server:ListenAddress 为上面 ConnectX.Server 的公网地址，以便访问

重要： ConnectX.Relay 可以有多个部署在不同的服务器上，连接到同一个 ConnectX.Server

  1. 放行 ConnectX.Server 以及 ConnectX.Relay 的端口 (Tcp/Udp)，默认分别为 3535 和 3536

  2. 运行 ConnectX.Server 以及 ConnectX.Relay

若 ConnectX.Server 输出中出现

[25-03-16 11:48:56 INF]: [ZTNodeService] Fetching ZT server node status...
[25-03-16 11:48:56 INF]: [ZTNodeService] Node status received, ID [495b749d3c] Version [1.14.2]
[25-03-16 11:48:57 INF]: [CLIENT_MANAGER] Watchdog started.

则 ConnectX.Server 成功连接到 Zerotier 控制器

若 ConnectX.Relay 输出中出现

[25-03-16 11:49:03 INF]: [CLIENT] Sending signin message to server...
[25-03-16 11:49:04 INF]: [CLIENT] Connected and signed to server at endpoint 127.0.0.1:3535
[25-03-16 11:49:04 INF]: [CLIENT] Server public address acquired [xxx.xx.xx.xx:3536]
[25-03-16 11:49:04 INF]: [CLIENT] Successfully registered relay server.

则 ConnectX.Relay 服务成功连接到 ConnectX.Server 服务

至此完成

ConnectX.Server 以及 ConnectX.Relay 的守护进程等配置在此不再过多赘述

使用 ConnectX.Client 连接时请使用 ConnectX.Server 的公网地址和端口进行连接

]]>natsurainkoWindows 使用 VMware 17 Pro 安装 Mac OS，搭建 iOS 开发环境2024-10-27T22:43:37+00:002024-10-27T22:43:37+00:00https://natsurainko.github.io/2024/10/27/windows-vmware-macos-ios本文参考文章

【2023最新版】VMware Workstation Pro v17安装教程+激活秘钥
Windows用VM虚拟机安装MacOS Ventura 13.6系统全流程教程

前言与其他方案论述

在最开始选择在 Windows 搭建 iOS 开发环境时，尽管 VMware 虚拟机（或是 Hyper-V）运行 Mac OS 的方案已经很多，但我第一选择没有选择它（尽管最后兜了一圈还是绕回来了）

先来说说 VMware 方案的缺点

  1. VMware 原生不支持 Mac OS 的安装，是需要使用第三方 Unlocker 之后才能创建 Mac OS 的虚拟机
  2. VMware 虚拟机运行的 Mac OS 事实上没办法调用显卡，也没任何方法安装显卡驱动或是借助某些手段间接调用显卡，这使得其对 CPU 的性能要求非常高
  3. VMware Tools 对于显示渲染的优化似乎并不好，甚至是负优化。在我测试时安装 VMware Tools 后，反而导致虚拟机容易崩溃，貌似因为反复渲染而导致虚拟机死机

VMware 方案的优点

  1. VMware（或 Hyper-V 等）虚拟机方便管理与保存虚拟机状态
  2. VMware（或 Hyper-V 等）虚拟机能够直接连接物理 USB，从而能从虚拟机调试物理设备（这是最为重要的）

最开始时我首先考虑到了 VMware 虚拟机的缺点，所以一开始采用的是 OSX-KVM 的方案
具体文章可以参考这两篇

在Windows11 WSL上通过QEMU KVM流畅运行macOS虚拟机（2024）
在 Windows 上流畅使用 MacOS 虚拟机

尽管 OSX-KVM 方案确实有它的好处
例如：

  1. 由于 Linux 下的 KVM 能够通过虚拟 GPU 硬件，间接调用物理显卡，因此在显示性能上远远超过 VMware 方案
  2. 调用 GPU 渲染，因此大大减轻了 CPU 的负载

但是！在我一遍遍排除万难在 Windows 11 上安装了 Wsl2，又在 Wsl 里面成功配置了 KVM 虚拟机，又成功安装 Mac OS 到了 KVM 虚拟机之后，最终才发现 USB 总线没办法透过两层虚拟机传给 Mac OS，这意味我没办法进行实机调试和安装，最终放弃了这个方案

当然如果只是想在 Windows 上体验 Mac OS，你可以选择此方案，只是稍微有些折腾，但是是可行的（我实测过可以，但过程有些痛苦）

安装 VMWare 17 Pro 虚拟机

安装虚拟机和过程在此不赘述，因为相关文章太多了
这里提供一篇安装步骤参考文章，以及找到的一个城通网盘的 VMWare 17 Pro 下载链接
（目前 VMware 被收购之后，下载软件本体变得极为困难，那个破登录、许可证始终搞不好）

【2023最新版】VMware Workstation Pro v17安装教程+激活秘钥
城通网盘 VMware17

在 VMware 虚拟机中安装 Mac OS

这里提供 Unlocker GitHub 下载地址，以及两个 Mac OS 的安装镜像，分别是 13 Ventura 和 14 Sonoma

[GitHub Releases] Unlocker 4.2.7
[mediafire] macOS Ventura ISO for VM by techrechard.com.iso
[mediafire] macOS Sonoma ISO by techrechard.com.iso

我个人建议选择 14 Sonoma 的镜像安装，
因为这个 13 Ventura 的镜像最高支持的 Xcode 版本是 Xcode 14.3.1 而它最多支持到 iOS 16.4，
现在最新的都已经是 iOS 18.1，像我自己的设备是 iOS 17.4，用 Ventura 完全没法开发，
而 macOS Sonoma 14.5 则支持最新的 iOS 18.1（提供的镜像是 14.0 的需要自己更新系统）

具体安装请参考这篇文章
Windows用VM虚拟机安装MacOS Ventura 13.6系统全流程教程

配置 Mac OS 虚拟机的序列号

在上一步安装 Mac OS 的步骤教程中，有一步是让你往虚拟机配置文件中添加如下配置

board-id.reflectHost = "FALSE"
board-id = "Mac-AA95B1DDAB278B95" 
hw.model.reflectHost = "FALSE" 
hw.model = "MacBookPro19,1" 
serialNumber.reflectHost = "FALSE" 
serialNumber = "C01234567890"

这一段配置其实就是在配置虚拟机的序列号，但是很明显上面的序列号代码 serialNumber 是乱写的

为什么要配置序列号代码

因为在高版本 Mac OS 登录 App Store 的时候会验证你的机器码（主要包括主板 Id，机器序列号，BIOS 序列号等）
如果乱写，或是三个对不上的话，是没办法登录 App Store 的
下面找了一段实测可以使用的机器码

board-id.reflectHost = "FALSE"
board-id = "Mac-94245B3640C91C81"
hw.model.reflectHost = "FALSE"
hw.model = "MacBook Pro"
serialNumber.reflectHost = "FALSE"
serialNumber = "C02JJ8B3DH2G"
smbios.reflectHost = "FALSE"

当然你也可以使用其他的 三码工具 来生成正确的机器码
例如 黑苹果自动获取与注入三码的方法，附相关工具，解锁iCloud变白果！
不过我们只需要拿到生成好的三码，之后写入到上面的配置文件的对应位置，不需要用那些注入工具

关于 VMware Tools

我自己在使用的时候发现安装了 VMware Tools 之后容易导致虚拟机一些渲染问题
同时加重了渲染负担，容易导致虚拟机渲染卡死，崩溃等问题

我个人认为是不建议安装的，尽管不装它也会导致一些问题，比如无法调整分辨率之类的，也请各位酌情考虑是否安装

VMware 虚拟机优化

有许多方案从不同的角度对虚拟机进行优化

  1. 使用 beamoff， 参考安装 Mac OS 教程流程的第六步
  2. 修改最小化动画，参考 苹果电脑设置应用最小化窗口时动画效果？
  3. 使用 Onyx，参考 优化不必要的动画，以减少Mac卡顿

Xcode 开发环境配置

安装 Xcode

请在此处选择合适版本的 Xcode 软件包下载并进行安装
More Downloads

安装 iOS 模拟器

首先需要强调的是，任何 iOS 真机调试，都需要 iOS 对应版本的模拟器
尽管 Xcode 安装时，会自带勾选一个该 Xcode 版本发布时最新的 iOS 版本的模拟器，但是这在大多数情况下都不适合真机调试
所以更多的你需要安装对应版本的 iOS 模拟器，你可以手动安装，就像下面这篇文章一样，你也可以在连接 iPhone 时，通过连接提示来安装对应的模拟器

关于手动安装请参考 Xcode15真机调试iOS17的方法

连接 iPhone 到 Mac OS

直接连接 iPhone 到电脑，在虚拟机已经启动的时候，第一次连接时 iPhone 会提示是否连接此设备到虚拟机，此时点击是即可，或者也可以在 iPhone 已连接到电脑后，在 VMware 虚拟机窗口的右下角，找到一排图标，其中找到手机的图标，右键它打开菜单选择连接

完成

至此完成了整个开发环境的搭建
过程十分艰难，我在此也只是概述其中步骤，并之抓了几个注意点阐述，更多的还是需要网上查阅大量的资料，结合自身情况考虑每一步操作

展示 1 展示 2

]]>natsurainko使用 hexo + github pages 搭建个人博客2024-10-23T21:55:53+00:002024-10-23T21:55:53+00:00https://natsurainko.github.io/2024/10/23/hexo-github-pages

本文参考文章地址

快速开始

创建 GitHub 仓库

创建一个名为 <username>.github.io 的仓库，其中 <username> 替换为你自己的用户名称
例如我的仓库 natsurainko.github.io

创建分支

在创建的 <username>.github.io 仓库下新建一个分支 source 用于存放你 hexo 的源代码，
而原分支 main 等下将用于 GitHub Pages 的部署

本地部署 hexo

克隆 <username>.github.io 仓库到本地，并切换到 source 分支
在此目录下运行以下命令

npm install -g hexo-cli
hexo init blog
cd blog
npm install

命令会在仓库目录下新建文件夹 /blog
并初始化 hexo 及其配置文件
接下来尝试运行这条命令来启动 hexo 本地服务器

hexo server

成功运行的话就算本地配置成功了
你可以将现在这部分的代码提交上分支进行保存

配置 hexo 主题

引用的帖子里面使用 Next 主题，
但如你所见，我自己搭建时使用的是 安知鱼主题 具体配置步骤可以看这篇文档

其他 hexo 主题可以看官方主题浏览页面

但配置 hexo 主题基本步骤基本都相同，就是
克隆主题仓库到 /blog/themes/<theme> ，其中 <theme> 为这个主题的名称
然后修改文件 /blog/_config.yml

theme: <theme>

然后重新运行 hexo server 应用主题

对于每个主题的细节配置，请修改这个文件 /blog/themes/<theme>/_config.yml，
每个主题的 _config.yml 并不相同，具体配置不在此赘述

修改、添加博客内容

对于个人信息，站点标题之类的配置，请修改文件 /blog/_config.yml
具体参见官方配置文档

# Site
title: "natsurainko 的博客"
subtitle: "Forever young erver strong ever brave"
description: "这里能看到我的一些开发经历和一些开发教程，<br>希望能对你有所帮助"
keywords:
author: Natsurainko
language: zh
timezone: ''

创建一篇新文章或者新的页面，请在 /blog 目录下运行这条命令

hexo new [layout] <title>

具体参见官方写作文档

部署 hexo 到 GitHub Pages

请先修改文件 /blog/_config.yml，例如

deploy:
  type: git
  repo: https://github.com/<username>/<username>.github.io.git
  branch: main

再安装部署工具 hexo-deployer-git，在 /blog 文件夹下运行

npm install hexo-deployer-git --save

最后再运行

hexo clean      #清除之前生成的东西
hexo generate   #生成静态文章，缩写hexo g
hexo deploy     #部署文章，缩写hexo d

注意： hexo deploy 命令会覆写仓库下 main 分支之前所有的提交，
所以最开始不建议将代码文件直接放在 main 分支下
且该命令会创建 /blog/.deploy_git 文件夹，用于存放之前的提交，
如果删除了这个文件夹，下一次部署的时候之前的提交记录就会丢失

至此完成部署

请访问 http://<username>.github.io 以访问你的博客

]]>natsurainko