rustfs/rustfs

RustFS คือระบบจัดเก็บอ็อบเจกต์แบบกระจายประสิทธิภาพสูงที่สร้างด้วย Rust ซึ่งเป็นหนึ่งในภาษาโปรแกรมที่ได้รับความนิยมมากที่สุดทั่วโลก RustFS ผสมผสานความเรียบง่ายของ MinIO เข้ากับความปลอดภัยของหน่วยความจำและประสิทธิภาพที่แท้จริงของ Rust โดยมีความเข้ากันได้กับ S3 API อย่างกว้างขวางสำหรับคุณสมบัติที่รองรับ เป็นโอเพนซอร์สโดยสมบูรณ์ และปรับให้เหมาะสมสำหรับ Data Lake, AI และเวิร์กโหลด Big Data

แตกต่างจากระบบจัดเก็บข้อมูลอื่น ๆ RustFS ได้รับการเผยแพร่ภายใต้ไลเซนส์ Apache 2.0 ที่อนุญาตให้ใช้งานได้ หลีกเลี่ยงข้อจำกัดของ AGPL ด้วย Rust เป็นรากฐาน RustFS มอบความเร็วที่เหนือกว่าและคุณสมบัติแบบกระจายที่ปลอดภัยสำหรับการจัดเก็บอ็อบเจกต์ยุคใหม่

คุณสมบัติและสถานะ

• ประสิทธิภาพสูง: สร้างด้วย Rust เพื่อให้มั่นใจถึงความเร็วสูงสุดและประสิทธิภาพการใช้ทรัพยากร
• สถาปัตยกรรมแบบกระจาย: การออกแบบที่ปรับขนาดได้และทนทานต่อข้อผิดพลาด เหมาะสำหรับการติดตั้งใช้งานขนาดใหญ่
• ความเข้ากันได้กับ S3: การผสานรวมที่ราบรื่นกับแอปพลิเคชันและเครื่องมือที่เข้ากันได้กับ S3 ทั่วไป; ความครอบคลุมปัจจุบันถูกติดตามใน S3 compatibility matrix
• OpenStack Swift API: รองรับโปรโตคอล Swift แบบเนทีฟพร้อมการยืนยันตัวตนด้วย Keystone
• การผสานรวม OpenStack Keystone: รองรับการยืนยันตัวตน OpenStack Keystone แบบเนทีฟด้วยเฮดเดอร์ X-Auth-Token
• รองรับ Data Lake: ปรับให้เหมาะสมสำหรับเวิร์กโหลด Big Data และ AI ที่มีปริมาณงานสูง
• โอเพนซอร์ส: ได้รับอนุญาตภายใต้ Apache 2.0 ส่งเสริมการมีส่วนร่วมของชุมชนและการใช้งานเชิงพาณิชย์โดยไม่มีข้อจำกัด
• ใช้งานง่าย: ออกแบบโดยคำนึงถึงความเรียบง่าย เพื่อการติดตั้งและการจัดการที่ง่ายดาย

ประสิทธิภาพของ RustFS เทียบกับ MinIO

สภาพแวดล้อมการทดสอบความเครียด:

https://github.com/user-attachments/assets/2e4979b5-260c-4f2c-ac12-c87fd558072a

RustFS เทียบกับระบบจัดเก็บอ็อบเจกต์อื่น ๆ

ก้าวไปข้างหน้า

กด Star RustFS บน GitHub และรับการแจ้งเตือนการเปิดตัวเวอร์ชันใหม่ทันที

เริ่มต้นใช้งานอย่างรวดเร็ว

ในการเริ่มต้นใช้งาน RustFS ให้ทำตามขั้นตอนเหล่านี้:

1. การติดตั้งในคลิกเดียว (ตัวเลือกที่ 1)

curl -O https://rustfs.com/install_rustfs.sh && bash install_rustfs.sh

2. เริ่มต้นใช้งาน Docker อย่างรวดเร็ว (ตัวเลือกที่ 2)

คอนเทนเนอร์ RustFS ทำงานในฐานะผู้ใช้ที่ไม่ใช่ root ชื่อ rustfs (UID/GID 10001:10001) หากคุณ bind-mount ไดเรกทอรีโฮสต์ด้วย Docker หรือ Compose ทุกพาธที่ถูกเมาท์จะต้องสามารถเขียนได้โดยผู้ใช้นั้น มิฉะนั้นการเริ่มต้นอาจล้มเหลวเนื่องจากข้อผิดพลาด "permission denied" ซึ่งรวมถึงไดเรกทอรีข้อมูล ไดเรกทอรีบันทึก และไดเรกทอรีใบรับรอง TLS เมื่อเปิดใช้งาน RUSTFS_TLS_PATH

bash

สร้างไดเรกทอรี data และ logs

mkdir -p data logs

เปลี่ยนเจ้าของไดเรกทอรีเหล่านี้

chown -R 10001:10001 data logs

ใช้เวอร์ชันล่าสุด

docker run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data -v $(pwd)/logs:/logs rustfs/rustfs:latest

ใช้เวอร์ชันที่ระบุ

docker run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data -v $(pwd)/logs:/logs rustfs/rustfs:1.0.0-rc.2

หากคุณใช้ [podman](https://github.com/containers/podman) แทน docker คุณสามารถติดตั้ง RustFS ด้วยคำสั่งด้านล่าง

```bash
# สร้างไดเรกทอรี data และ logs
mkdir -p data logs

# รันคอนเทนเนอร์ (podman จะตั้งค่าความเป็นเจ้าของโฟลเดอร์โดยอัตโนมัติ)
podman run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data:Z,U -v $(pwd)/logs:/logs:Z,U rustfs/rustfs:latest

หากคุณเปิดใช้งาน TLS ด้วยไดเรกทอรีใบรับรองที่เมาท์แบบ bind-mounted ให้เตรียมการเมาท์นั้นในลักษณะเดียวกัน:

mkdir -p certs
chown -R 10001:10001 certs

คุณยังสามารถใช้ Docker Compose ได้ โดยใช้ไฟล์ docker-compose-simple.yml ในไดเรกทอรีรูท:

docker compose -f docker-compose-simple.yml up -d

ก่อนรัน Compose ด้วย host bind mounts:

• ตรวจสอบให้แน่ใจว่าพาธโฮสต์ที่เมาท์ทุกพาธสามารถเขียนได้โดย 10001:10001
• หากคุณเปิดใช้งาน TLS ตรวจสอบให้แน่ใจว่าการเมาท์ใบรับรองสำหรับ /opt/tls สามารถอ่านได้โดย 10001:10001 ด้วย
• หากการจับคู่ความเป็นเจ้าของโฮสต์ไม่สามารถทำได้ ให้รันบริการ rustfs ด้วย user: "<host-uid>:<host-gid>" แทน
• docker-compose-simple.yml มีบริการ volume-permission-helper สำหรับ named volumes docker-compose-simple.yml อาศัยคุณในการเตรียมพาธโฮสต์ที่เมาท์แบบ bind-mounted ล่วงหน้า

ในทำนองเดียวกัน คุณสามารถรันคำสั่งด้วย podman

podman compose -f docker-compose-simple.yml up -d

เริ่มต้นใช้งานการแจ้งเตือน Webhook อย่างรวดเร็ว (Docker):

docker run -d --name rustfs -p 9000:9000 \
  -e RUSTFS_NOTIFY_ENABLE=true \
  -e RUSTFS_NOTIFY_WEBHOOK_ENABLE_PRIMARY=on \
  -e RUSTFS_NOTIFY_WEBHOOK_ENDPOINT_PRIMARY=http://<host-ip>:3020/webhook \
  -e RUSTFS_NOTIFY_WEBHOOK_QUEUE_DIR_PRIMARY=/tmp/rustfs-events \
  -e RUSTFS_OUTBOUND_ALLOW_ORIGINS=http://<host-ip>:3020 \
  rustfs/rustfs:latest

หมายเหตุ:

• RUSTFS_NOTIFY_ENABLE=true เปิดใช้งานสวิตช์โมดูลการแจ้งเตือนทั่วโลก
• สำหรับ ARN arn:rustfs:sqs::primary:webhook ให้ใช้ตัวแปรสภาพแวดล้อมแบบ instance-scoped ที่มี _PRIMARY
• หากละเว้นไดเรกทอรีคิว ค่าเริ่มต้นคือ /opt/rustfs/events; ตรวจสอบให้แน่ใจว่าสามารถเขียนได้โดยผู้ใช้รันไทม์ของคอนเทนเนอร์
• RUSTFS_NOTIFY_WEBHOOK_SKIP_TLS_VERIFY_PRIMARY มีค่าเริ่มต้นเป็น false; การเปิดใช้งานจะข้ามการตรวจสอบใบรับรอง TLS ของ webhook อนุญาตการโจมตีแบบ MITM และแสดงคำเตือนเมื่อเริ่มต้นทำงาน ควรใช้ RUSTFS_NOTIFY_WEBHOOK_CLIENT_CA_PRIMARY สำหรับ CA ส่วนตัว
• ตั้งแต่ 1.0.0-beta.11 เป็นต้นไป ปลายทาง webhook บนเครือข่ายส่วนตัวหรือเครือข่ายคอนเทนเนอร์ (ชื่อบริการ Docker Compose, host.docker.internal, ที่อยู่ RFC 1918) จะ ถูกบล็อก เว้นแต่ว่า scheme://host:port ต้นทางที่แน่นอนจะถูกระบุไว้ใน RUSTFS_OUTBOUND_ALLOW_ORIGINS (เฉพาะต้นทางเท่านั้น ไม่มีพาธ) ดู Outbound Connection Policy

หมายเหตุ: เราขอแนะนำให้ตรวจสอบไฟล์ docker-compose.yml ก่อนรัน ไฟล์นี้กำหนดบริการหลายอย่างรวมถึง Grafana, Prometheus และ Jaeger ซึ่งมีประโยชน์สำหรับการตรวจสอบ RustFS หากคุณต้องการเริ่มต้นคอนเทนเนอร์ Redis หรือ Nginx คุณสามารถระบุโปรไฟล์ที่เกี่ยวข้องได้

3. สร้างจาก Source (ตัวเลือกที่ 3) - สำหรับผู้ใช้ขั้นสูง

สำหรับนักพัฒนาที่ต้องการสร้างอิมเมจ Docker ของ RustFS จาก source พร้อมรองรับหลายสถาปัตยกรรม:

# สร้างอิมเมจหลายสถาปัตยกรรมในเครื่อง
./docker-buildx.sh --build-arg RELEASE=latest

# สร้างและพุชไปยัง registry
./docker-buildx.sh --push

# สร้างเวอร์ชันที่ระบุ
./docker-buildx.sh --release v1.0.0 --push

# สร้างสำหรับ registry ที่กำหนดเอง
./docker-buildx.sh --registry your-registry.com --namespace yourname --push

สคริปต์ docker-buildx.sh รองรับ:

• การสร้างหลายสถาปัตยกรรม: linux/amd64, linux/arm64
• การตรวจจับเวอร์ชันอัตโนมัติ: ใช้ git tags หรือ commit hashes
• ความยืดหยุ่นของ Registry: รองรับ Docker Hub, GitHub Container Registry และอื่นๆ
• การเพิ่มประสิทธิภาพการสร้าง: รวมถึงการแคชและการสร้างแบบขนาน

คุณยังสามารถใช้ Make targets เพื่อความสะดวก:

make docker-buildx                    # สร้างในเครื่อง
make docker-buildx-push               # สร้างและพุช
make docker-buildx-version VERSION=v1.0.0  # สร้างเวอร์ชันที่ระบุ
make help-docker                      # แสดงคำสั่งที่เกี่ยวข้องกับ Docker ทั้งหมด

4. สร้างด้วย Helm Chart (ตัวเลือกที่ 4) - Cloud Native

ทำตามคำแนะนำใน Helm Chart README เพื่อติดตั้ง RustFS บนคลัสเตอร์ Kubernetes

สำหรับการปรับจังหวะของสแกนเนอร์, งบประมาณรอบการทำงาน, จังหวะการเกิด bitrot, สถานะการเปลี่ยนผ่านวงจรชีวิต, และการปรับแต่ง CPU ที่ไม่ได้ใช้งานของโหนดเดียวดิสก์เดียว โปรดดู Scanner Runtime Controls สำหรับ การตรวจสอบแรงกดดันของสแกนเนอร์ที่ทำซ้ำได้ โปรดดู Scanner Benchmark Runbook สำหรับ การปรับแต่ง drive timeout บนพื้นที่เก็บข้อมูลที่ช้า — รวมถึง walk stall budget ที่ ควบคุม ListObjects บน prefix ขนาดใหญ่ — โปรดดู Drive Timeout Tuning

5. Nix Flake (ตัวเลือกที่ 5)

หากคุณมี Nix with flakes enabled:

# รันโดยตรงโดยไม่ต้องติดตั้ง
nix run github:rustfs/rustfs

# สร้างไบนารี
nix build github:rustfs/rustfs
./result/bin/rustfs --help

# หรือจาก local checkout
nix build
nix run

6. X-CMD (ตัวเลือกที่ 6)

หากคุณเป็นผู้ใช้ x-cmd:

# รันโดยตรงโดยไม่ต้องติดตั้ง
x rustfs

# ดาวน์โหลดไบนารีและติดตั้งลงในสภาพแวดล้อมส่วนกลาง
x env use rustfs
rustfs --help

การเข้าถึง RustFS

1. 1เข้าถึง Console: เปิดเว็บเบราว์เซอร์ของคุณและไปที่ http://localhost:9001 เพื่อเข้าถึงคอนโซล RustFS - ข้อมูลรับรองเริ่มต้น: `rustfsadmin` / `rustfsadmin`
2. 2สร้าง Bucket: ใช้คอนโซลเพื่อสร้าง bucket ใหม่สำหรับอ็อบเจกต์ของคุณ
3. 3อัปโหลด Objects: คุณสามารถอัปโหลดไฟล์โดยตรงผ่านคอนโซล หรือใช้ S3-compatible APIs/clients เพื่อโต้ตอบกับอินสแตนซ์ RustFS ของคุณ

หมายเหตุ: หากต้องการเข้าถึงอินสแตนซ์ RustFS ผ่าน https โปรดดูที่ TLS Configuration Docs

OIDC Roles Claim (Microsoft Entra ID)

RustFS รองรับการแมป OIDC claim ที่มีค่าบทบาทเข้าสู่ authorization pipeline ที่มีอยู่ การตั้งค่า roles_claim เป็น ทางเลือก: เมื่อไม่ได้ตั้งค่าหรือว่างเปล่า เฉพาะ groups claim เท่านั้นที่มีส่วนร่วมในการอนุญาต (เช่นเดียวกับ RustFS เวอร์ชันเก่า) สำหรับ Microsoft Entra ID app roles ให้ตั้งค่า roles_claim=roles เพื่อให้ทั้งการตรวจสอบผู้ดูแลระบบคอนโซลและนโยบาย IAM ของ bucket สามารถประเมินบทบาทเหล่านั้นได้

ตัวอย่างการกำหนดค่าสภาพแวดล้อม (opt-in roles claim):

RUSTFS_IDENTITY_OPENID_ENABLE=on
RUSTFS_IDENTITY_OPENID_CONFIG_URL="https://login.microsoftonline.com/<tenant-id>/v2.0/.well-known/openid-configuration"
RUSTFS_IDENTITY_OPENID_CLIENT_ID="<client-id>"
RUSTFS_IDENTITY_OPENID_CLIENT_SECRET="<client-secret>"
RUSTFS_IDENTITY_OPENID_SCOPES="openid,profile,email"
RUSTFS_IDENTITY_OPENID_GROUPS_CLAIM="groups"
RUSTFS_IDENTITY_OPENID_ROLES_CLAIM="roles"

ตัวอย่างเงื่อนไขนโยบาย (ประเมิน app roles โดยตรงด้วย jwt:roles; เมื่อกำหนดค่า roles_claim แล้ว RustFS จะรวมค่าเหล่านั้นเข้ากับ jwt:groups เพื่อความเข้ากันได้ย้อนหลังกับนโยบายเก่า):

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["admin:*"],
      "Resource": ["arn:aws:s3:::*"],
      "Condition": {
        "ForAnyValue:StringEquals": {
          "jwt:roles": ["RustFS.ConsoleAdmin"]
        }
      }
    }
  ]
}

เอกสารประกอบ

สำหรับเอกสารประกอบโดยละเอียด รวมถึงตัวเลือกการกำหนดค่า, การอ้างอิง API และการใช้งานขั้นสูง โปรดเยี่ยมชม เอกสารประกอบ ของเรา

ขอความช่วยเหลือ

หากคุณมีคำถามหรือต้องการความช่วยเหลือ:

• ตรวจสอบ FAQ สำหรับปัญหาและวิธีแก้ไขทั่วไป
• เข้าร่วม GitHub Discussions ของเราเพื่อถามคำถามและแบ่งปันประสบการณ์ของคุณ
• เปิด issue บนหน้า GitHub Issues ของเราสำหรับรายงานข้อผิดพลาดหรือคำขอคุณสมบัติ

ลิงก์

• เอกสารประกอบ - คู่มือที่คุณควรอ่าน
• Changelog - สิ่งที่เราแก้ไขและปรับปรุง
• GitHub Discussions - ที่ที่ชุมชนอาศัยอยู่
• Discord - แชทกับชุมชน RustFS

ติดต่อ

• ข้อบกพร่อง: GitHub Issues
• ธุรกิจ: hello@rustfs.com
• ตำแหน่งงาน: jobs@rustfs.com
• การพูดคุยทั่วไป: GitHub Discussions
• การมีส่วนร่วม: CONTRIBUTING.md

ผู้มีส่วนร่วม

RustFS เป็นโปรเจกต์ที่ขับเคลื่อนโดยชุมชน และเราขอขอบคุณทุกการมีส่วนร่วม ตรวจสอบหน้า Contributors เพื่อดูบุคคลที่น่าทึ่งที่ช่วยทำให้ RustFS ดีขึ้น

ประวัติ Star

สิทธิ์การใช้งาน

Apache 2.0

RustFS เป็นเครื่องหมายการค้าของ RustFS, Inc. เครื่องหมายการค้าอื่นๆ ทั้งหมดเป็นทรัพย์สินของเจ้าของที่เกี่ยวข้อง