ติดตั้ง Host Storage

ภาพรวม

Host Storage คือเซิร์ฟเวอร์เก็บไฟล์ที่คุณติดตั้งและดูแลเอง ไฟล์ที่อัปโหลดในหน้า ไฟล์ จะถูกเก็บบนดิสก์ของเครื่องคุณ และผู้เล่นดาวน์โหลดผ่าน URL ของเซิร์ฟเวอร์นี้ เหมาะถ้าอยากควบคุมที่เก็บไฟล์เองและไม่อยากใช้บริการคลาวด์ (ถ้าไม่อยากดูแลเซิร์ฟเวอร์ ใช้ S3 / R2 แทนได้ ดู Storage)

แพ็กเกจที่ให้ดาวน์โหลดมีทุกอย่างที่ต้องใช้ - ตั้งค่า 3 อย่างก็รันได้:

• เซิร์ฟเวอร์เล็กๆ ไฟล์เดียว ใช้ Node.js หรือ Docker ก็ได้
• ตรวจความถูกต้องของไฟล์ (SHA-1) ทุกครั้งที่อัปโหลด ถ้าไฟล์เสียหายจะไม่เก็บ
• ไม่ต้องมีฐานข้อมูล ไฟล์ทั้งหมดอยู่ในโฟลเดอร์เดียว สำรองข้อมูลง่าย

สิ่งที่ต้องเตรียม

ดาวน์โหลด

แตกไฟล์แล้วจะได้โฟลเดอร์ dimension-host-storage ประกอบด้วย:

ตั้งค่า (ไฟล์ .env)

ในโฟลเดอร์ที่แตกไฟล์ ให้คัดลอก .env.example เป็น .env แล้วแก้ค่า:

# Linux / macOS
cp .env.example .env

# Windows (Command Prompt)
copy .env.example .env

สร้าง API_KEY

รันคำสั่งนี้ แล้วคัดลอกผลลัพธ์ไปใส่ใน API_KEY:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

ตัวอย่างไฟล์ .env ที่ตั้งค่าเสร็จแล้ว:

API_KEY=9f2c1a7e5b8d4c0a93e1f6b7d2a4c8e05b1d9f3a7c6e2b4d8f0a1c3e5b7d9f21
PUBLIC_URL=https://storage.example.com
PORT=8080
ALLOWED_ORIGINS=https://manager.example.com

ติดตั้งและรัน (แบบ Node.js)

1. 1

   ติดตั้งแพ็กเกจ

   เปิดเทอร์มินัลในโฟลเดอร์ที่แตกไฟล์:

   bash

   npm install

2. 2

   ตั้งค่า .env (ตามหัวข้อด้านบน)

3. 3

   รันเซิร์ฟเวอร์

   bash

   npm start

   ถ้าตั้งค่าถูกต้อง จะเห็นข้อความ "Dimension Host Storage is running" พร้อมสรุปค่าที่ใช้อยู่ ถ้าลืมตั้ง API_KEY โปรแกรมจะบอกและหยุดทำงาน

4. 4

   ตรวจว่าทำงาน

   เปิด http://localhost:8080/health (หรือ PUBLIC_URL/health) ควรเห็น:

   json

   {"status":"ok","service":"dimension-host-storage","signedDownloads":true,"privateFiles":true}

ให้ทำงานต่อเนื่อง (ไม่หยุดเมื่อปิดเทอร์มินัล)

ใช้ pm2 (ตัวจัดการโปรเซสของ Node.js):

npm install -g pm2
pm2 start server.js --name host-storage
pm2 save
pm2 startup        # ทำตามคำสั่งที่แสดง เพื่อให้เปิดเองหลังรีบูตเครื่อง

คำสั่งที่ใช้บ่อย: pm2 logs host-storage (ดู log), pm2 restart host-storage (รีสตาร์ท), pm2 stop host-storage (หยุด)

ติดตั้งและรัน (แบบ Docker)

1. 1

   ตั้งค่า .env (คัดลอกจาก .env.example และแก้ API_KEY, PUBLIC_URL)

2. 2

   สั่งรัน

   bash

   docker compose up -d

   ไฟล์ที่อัปโหลดจะอยู่ในโฟลเดอร์ ./storage ข้างๆ ไฟล์ docker-compose.yml

3. 3

   ตรวจสถานะและ log

   bash

   docker compose ps
   docker compose logs -f

อัปเดตเวอร์ชัน: แทนที่ไฟล์ในโฟลเดอร์ด้วยเวอร์ชันใหม่ แล้วรัน docker compose up -d --build

ทำ HTTPS

เว็บนี้ใช้ https ดังนั้นเซิร์ฟเวอร์เก็บไฟล์ก็ต้องเป็น https ด้วย (ไม่งั้นเบราว์เซอร์จะบล็อกการอัปโหลด) วิธีที่ง่ายที่สุดคือใช้ reverse proxy หน้าเซิร์ฟเวอร์:

แบบ Caddy (ง่ายที่สุด - ขอใบรับรองให้อัตโนมัติ)

1. ชี้ DNS ของโดเมน (เช่น storage.example.com) มาที่ IP ของเครื่อง
2. ติดตั้ง Caddy แล้วใช้ไฟล์ Caddyfile.example ในแพ็กเกจเป็นต้นแบบ:

storage.example.com {
    request_body {
        max_size 1GB
    }
    reverse_proxy localhost:8080
}

จากนั้นตั้ง PUBLIC_URL=https://storage.example.com ใน .env แล้วรีสตาร์ทเซิร์ฟเวอร์

แบบ nginx

server {
    server_name storage.example.com;
    client_max_body_size 1g;          # ต้องไม่น้อยกว่า MAX_SIZE_MB

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_request_buffering off;  # ส่งไฟล์ต่อให้เซิร์ฟเวอร์ทันที ไม่พักไว้ที่ nginx
    }
    # ใส่ใบรับรอง HTTPS เช่นด้วย certbot
}

เปิดพอร์ต

ถ้ามีไฟร์วอลล์ ให้เปิดพอร์ต 80 และ 443 (ถ้าใช้ reverse proxy) หรือพอร์ตของเซิร์ฟเวอร์เองถ้าไม่ใช้ เช่นบน Ubuntu:

sudo ufw allow 80
sudo ufw allow 443

เชื่อมกับ Instance

1. 1

   เปิด การตั้งค่า → Storage → เพิ่ม Storage

2. 2

   เลือก Host Storage

3. 3

   กรอกข้อมูล

   ช่องในหน้าเว็บ	ค่าที่ใส่
   ชื่อ Storage	ตั้งชื่ออะไรก็ได้ เช่น Host หลัก
   Base URL ของ Storage Server	ค่า PUBLIC_URL ใน .env (เช่น https://storage.example.com)
   API Key	ค่า API_KEY ใน .env
   Path prefix	ปล่อยตามค่าเริ่มต้น (ชื่อ Instance) ได้

4. 4

   บันทึก แล้วลองอัปโหลดไฟล์ในแท็บไฟล์

   ถ้าอัปโหลดสำเร็จ ไฟล์จะปรากฏในรายการและในโฟลเดอร์ storage ของเซิร์ฟเวอร์

ลิงก์ดาวน์โหลดที่หมดอายุ

เว็บนี้ส่งลิงก์ดาวน์โหลดที่มีลายเซ็นและวันหมดอายุ (?exp=...&sig=...) ให้ launcher ของผู้เล่นทุกครั้ง ลิงก์ใช้ได้ 30-45 นาที (แค่ต้องเริ่มโหลดก่อนหมดเวลา) แล้ว launcher จะได้ลิงก์ใหม่เองตอนเช็กไฟล์ครั้งถัดไป ลายเซ็นทำจาก API_KEY ของ Storage นั้น

อัปเดตเซิร์ฟเวอร์เป็นเวอร์ชันใหม่แล้วเปิดใช้เอง ตรวจได้ที่ /health ว่า "privateFiles":true ถ้าอยากให้ไฟล์เปิดสาธารณะเหมือนเดิม เพิ่ม PRIVATE_FILES=0 ใน .env แล้วรีสตาร์ท

ไฟล์ถูกเก็บอย่างไร

ไฟล์ถูกวางในโฟลเดอร์ storage (หรือที่ตั้งใน STORAGE_DIR) ภายใต้โฟลเดอร์ Path prefix ด้วยชื่อสุ่ม เช่น:

storage/
└── my_server/                              ← Path prefix (ชื่อ Instance)
    ├── 3f2c9a1e-5b7d-4c0a-9e88-1d2f6a7b8c90
    └── a81d77f0-92c4-4b53-8d1e-0c5f9e2a6b13

ชื่อไฟล์จริง (เช่น mods/sodium.jar) ถูกจำไว้ในระบบ ไม่ใช่ชื่อบนดิสก์ จึงอย่าเปลี่ยนชื่อหรือย้ายไฟล์ในโฟลเดอร์นี้เอง

ดูแลรักษา

สำรองข้อมูล

คัดลอกโฟลเดอร์ storage ไปเก็บไว้เป็นระยะ (และไฟล์ .env เผื่อต้องตั้งเซิร์ฟเวอร์ใหม่)

อัปเดตเวอร์ชัน

ดาวน์โหลดแพ็กเกจใหม่ แทนที่ server.js และ package.json แล้วรัน npm install และรีสตาร์ท อย่าลบไฟล์ .env และโฟลเดอร์ storage

ย้ายไปเครื่องใหม่

1. ตั้งเซิร์ฟเวอร์ใหม่ตามขั้นตอนด้านบน ใช้ .env เดิม
2. คัดลอกโฟลเดอร์ storage ไปไว้ที่เครื่องใหม่
3. ชี้โดเมนเดิมมาที่เครื่องใหม่ (ถ้าเปลี่ยนโดเมน ลิงก์ของไฟล์เดิมในระบบจะชี้ไปโดเมนเก่า)

เปลี่ยน API_KEY

1. แก้ API_KEY ใน .env แล้วรีสตาร์ทเซิร์ฟเวอร์
2. ในหน้าเว็บ ไปที่ Storage นั้นกดแก้ไข ใส่ API Key ใหม่ แล้วบันทึก

ถ้าเปิด PRIVATE_FILES อยู่ ระหว่างสองขั้นตอนนี้ลิงก์ดาวน์โหลดจะใช้ไม่ได้ ควรทำต่อกันทันที

แก้ปัญหาเบื้องต้น

ปัญหาอื่นๆ ดู คำถามที่พบบ่อยและแก้ปัญหา และอ่านเพิ่มเรื่องการใช้ Storage ที่ Storage