来自 Arkitektonika 的Fork
Arkitektonika 是一个用于 NBT 数据的 REST 存储库。它接受有效的 NBT 数据上传，并将其存储在本地文件夹中，同时在本地 SQLite 数据库中记录其元数据。可以选择通过运行 prune 脚本，根据可配置的时间戳来过期上传的文件。通过其删除密钥，文件可以被永久删除。
示例实例：
| 地址 | 过期时间 |
|---|---|
| https://api.schem.alsace.team/ | 30 天 |
docker pull alsacework/arkitektonika可以在 https://hub.docker.com/r/intellectualsites/arkitektonika 上找到
git clone https://github.com/IntellectualSites/Arkitektonika.git &&
cd Arkitektonika &&
yarn installyarn start:prodyarn start克隆整个仓库并运行以下命令：
docker buildx build --platform linux/amd64,linux/arm64 -t alsaceteam/arkitektonika:dev --push .示例 Docker Compose：
version: '3.8'
services:
arkitektonika:
container_name: Arkitektonika
image: alsacework/arkitektonika:latest
restart: unless-stopped
volumes:
- /home/ark/data:/data # 挂载包含配置文件、数据库和示意图存储的 data 文件夹
environment:
- LOG_LEVEL=DEBUG # 如果应该将调试日志打印到控制台/data 挂载到主机的 /home/ark/data，因为该文件夹包含持久数据。
执行带有 prune 标志的启动命令以执行清理例程：
yarn start:prod --prune创建一个在您想要的频率运行的 cron 作业。例如，这将在每 12 小时运行一次清理脚本：
0 */12 * * * cd /srv/arkitektonika && /usr/bin/yarn start:prod --prune或者使用 Docker Compose 配置：
0 */12 * * * cd /srv/arkitektonika && docker-compose run --rm arkitektonika node app/launch.js --prune{
"port": 3000,
"prune": 1800000,
"maxIterations": 20,
"maxSchematicSize": 1000000,
"limiter": {
"windowMs": 60000,
"delayAfter": 30,
"delayMs": 500
}
}| 配置键 | 描述 |
|---|---|
| port | 应用程序绑定的端口 |
| prune | 定义记录被清理脚本删除之前的最旧时间（以毫秒为单位） |
| maxIterations | 获取唯一下载和删除令牌的最大迭代次数 |
| maxSchematicSize | 接受的示意图文件的最大大小（以字节为单位） |
| limiter.windowMs | 限制器的时间框架（经过多长时间后限制重置） |
| limiter.delayAfter | 在 windowMs 期间的多少请求后应该应用 delayMs |
| limiter.delayMs | 请求应该延迟多少毫秒。公式：currentRequestDelay = (currentRequestAmount - delayAfter) * delayMs |
data
├── config.json
├── database.db
└── schemata
├── fe65d7edc37149c47171962dc26a039b
└── a98f299c5cf294e6555617e83226bcdd
config.json 保存用户配置数据
database.db 保存每个示意图所需的数据
schemata 保存所有示意图文件数据
所有路由将在公开的端口可用（例如 localhost:3000）。
POST INSTANCE_URL/upload: 将您的文件作为 multipart/form-data 发送；示例：
curl --location --request POST 'http://localhost:3000/upload' \
--form 'schematic=@/path/to/plot.schem'响应：
| 代码 | 含义 |
|---|---|
| 200 | 文件格式为有效的 NBT，并且已被接受 |
| 400 | 文件格式无效 |
| 413 | 文件负载过大，被拒绝 |
| 500 | 文件上传后在磁盘上找不到（上传失败） |
成功响应：
{
"download_key": "db6186c8795740379d26fc61ecba1a24",
"delete_key": "11561161dffe4a1298992ce063be5ff9"
}下载密钥允许您下载文件，删除密钥允许您删除文件。分享 download_key，但不要分享 delete_key。
HEAD INSTANCE_URL/download/:download_key: 检查如果发送带有给定 download_key 的 POST 请求会得到哪些头信息；示例：
curl --location --head 'http://localhost:3000/download/db6186c8795740379d26fc61ecba1a24'响应形式为状态码。
| 状态码 | 含义 |
|---|---|
| 200 | 找到文件，预期下载成功 |
| 404 | 数据库中找不到文件 |
| 410 | 文件元数据在记录表中，但文件不在磁盘上或已过期 |
| 500 | 由于元数据损坏（数据库中缺少数据），发生内部服务器错误 |
GET INSTANCE_URL/download/:download_key: 使用给定的 download_key 下载文件；示例：
curl --location --request GET 'http://localhost:3000/download/db6186c8795740379d26fc61ecba1a24'响应： 见上文 检查下载头信息。
成功时，文件作为附件发送到浏览器/请求者。
HEAD INSTANCE_URL/delete/:delete_key: 检查如果发送带有给定 delete_key 的 DELETE 请求会得到哪些头信息；示例：
curl --location --head 'http://localhost:3000/delete/11561161dffe4a1298992ce063be5ff9'响应形式为状态码。
| 状态码 | 含义 |
|---|---|
| 200 | 找到文件，预期删除成功 |
| 404 | 数据库中找不到文件 |
| 410 | 文件元数据在记录表中，但文件不在磁盘上或已过期 |
| 500 | 由于元数据损坏（数据库中缺少数据），发生内部服务器错误 |
DELETE PUBLIC_URL/delete/:delete_key: 使用给定的 delete_key 删除文件；示例：
curl --location --request DELETE 'http://localhost:3000/delete/11561161dffe4a1298992ce063be5ff9'响应： 见上文 检查删除头信息。
成功时，文件被删除，并在数据库中标记为已过期。