การติดตั้ง
NautilusTrader รองรับอย่างเป็นทางการบนแพลตฟอร์ม 64 บิตต่อไปนี้:
| ระบบปฏิบัติการ | เวอร์ชันที่รองรับ | สถาปัตยกรรม CPU |
|---|---|---|
| Linux (Ubuntu) | 22.04 and later | x86_64 |
| Linux (Ubuntu) | 22.04 and later | ARM64 |
| macOS | 15.0 and later | ARM64 |
| Windows Server | 2022 and later | x86_64 |
NautilusTrader อาจทำงานได้บนแพลตฟอร์มอื่น แต่มีเฉพาะแพลตฟอร์มข้างต้นที่นักพัฒนาใช้งานเป็นประจำและทดสอบใน CI
CI ที่รันต่อเนื่องมาจาก GitHub Actions runner ที่โปรเจกต์ใช้ build:
- build ของ
Linux (Ubuntu)ปัจจุบัน pin ไว้ที่ubuntu-22.04เพื่อคงความเข้ากันได้กับ glibc 2.35 แม้ubuntu-latestจะขยับไปข้างหน้าแล้ว - build ของ
macOS (ARM64)รันบนmacos-latestการรองรับจึงขยับตาม image ของ runner นั้น - build ของ
Windows (x86_64)ปัจจุบัน pin ไว้ที่windows-2022เพื่อให้ toolchain คงที่
บน Linux ให้ตรวจเวอร์ชัน glibc ด้วย ldd --version และตรวจให้แน่ใจว่าเป็น 2.35 หรือใหม่กว่าก่อนดำเนินการต่อ
การใช้งานจาก Rust: crate ของ Nautilus เผยแพร่อยู่บน crates.io และเพิ่มลงใน Cargo.toml ได้โดยตรง
ดูรายการ crate, feature flag และเวอร์ชัน Rust ขั้นต่ำ (MSRV) ได้ที่หัวข้อ
การตั้งค่าโปรเจกต์ ส่วนหัวข้อด้านล่างอธิบายการเตรียม toolchain และการ build จาก source
ตรวจสอบที่มาของ build
artifact ทุกตัวที่โปรเจกต์เผยแพร่มี cryptographic attestation ที่สร้างโดย CI/CD pipeline:
- Docker image (
ghcr.io/nautechsystems/nautilus_trader): ลายเซ็น cosign แบบ keyless พร้อม SPDX SBOM attestation
attestation ออกผ่าน Sigstore และผูกกับ commit SHA ที่เจาะจง การตรวจสอบจึงยืนยันได้ว่า artifact ถูกสร้างโดย GitHub Actions workflow ทางการของ NautilusTrader และไม่ถูกแก้ไขหลังจากนั้น
ดูคำสั่งตรวจสอบทีละขั้นตอนได้ที่ Verifying releases ใน SECURITY.md
การตรวจสอบ Docker image ต้องใช้ cosign
ติดตั้งจาก source
1. ติดตั้ง rustup
ติดตั้ง rustup (ตัวติดตั้ง Rust toolchain):
curl https://sh.rustup.rs -sSf | shตรวจสอบ: rustc --version
2. เปิดใช้ cargo
เปิดใช้ cargo ใน shell ปัจจุบัน:
source $HOME/.cargo/env3. ติดตั้ง clang
ติดตั้ง clang (frontend ภาษา C สำหรับ LLVM) บน Linux คำสั่งนี้จะติดตั้ง lld ด้วย ซึ่งถูกตั้งค่าให้เป็น linker ของ Rust เพื่อให้ build เร็วขึ้น:
sudo apt-get install clang lldตรวจสอบ: clang --version
4. Clone source
clone source ด้วย git:
git clone --branch develop --depth 1 https://github.com/nautechsystems/nautilus_trader
cd nautilus_traderสำหรับเครื่องที่ใช้พัฒนาและ image ของ CI runner ให้ดู แหล่งอ้างอิงเวอร์ชันเพียงแหล่งเดียว ก่อนติดตั้งเครื่องมือที่ pin เวอร์ชันไว้
flag --depth 1 ดึงเฉพาะ commit ล่าสุด ทำให้ clone ได้เร็วและเบากว่า
5. ติดตั้ง Cap'n Proto สำหรับ HyperSync
compiler ของ Cap'n Proto ยังมีไว้สำหรับการพัฒนา schema ของ HyperSync
dependency ของ HyperSync ที่ pin ไว้มาพร้อม Rust binding ที่ generate ไว้แล้ว build ปกติจึงไม่ต้อง generate schema ใหม่
บน Linux หรือ macOS ให้ใช้ script ใน repository เพื่อติดตั้ง compiler ตามเวอร์ชันที่ pin ไว้ใน
.nautilus-engineering/tools.toml:
./scripts/install-capnp.shตรวจสอบ: capnp --version
Cap'n Proto เป็น development dependency
ขั้นตอนถัดไป: ดูแนวทางการเขียนและทดสอบโค้ด Rust ของโปรเจกต์ได้ที่ Rust ในคู่มือนักพัฒนา หรือเริ่มเขียนโปรเจกต์ของตัวเองตาม รัน backtest (Rust) และ Write a Strategy (Rust)
เวอร์ชันและการ release
NautilusTrader ยังอยู่ระหว่างการพัฒนาอย่างต่อเนื่อง บาง feature อาจยังไม่สมบูรณ์ และแม้ API จะเริ่มเสถียรขึ้น แต่ก็อาจมี breaking change ระหว่าง release ได้ โปรเจกต์พยายามบันทึกการเปลี่ยนแปลงเหล่านี้ไว้ใน release notes แบบ best-effort
โปรเจกต์ตั้งเป้า release ทุกสองสัปดาห์ แม้ feature ทดลองหรือ feature ขนาดใหญ่อาจทำให้ล่าช้าได้
ใช้ NautilusTrader เฉพาะเมื่อคุณพร้อมจะปรับตัวตามการเปลี่ยนแปลงเหล่านี้
Redis
การใช้ Redis กับ NautilusTrader เป็นทางเลือก และจำเป็นเฉพาะเมื่อตั้งค่าให้เป็น backend ของ cache database หรือ message bus
Redis เวอร์ชันต่ำสุดที่รองรับคือ 6.2 (จำเป็นสำหรับความสามารถ streams)
สำหรับการตั้งค่าอย่างรวดเร็ว แนะนำให้ใช้ Redis Docker container ดูตัวอย่างการตั้งค่าได้ใน
directory .docker หรือรันคำสั่งต่อไปนี้เพื่อเริ่ม container:
docker run -d --name redis -p 6379:6379 redis:latestคำสั่งนี้จะ:
- ดึง Redis เวอร์ชันล่าสุดจาก Docker Hub ถ้ายังไม่ได้ดาวน์โหลด
- รัน container ในโหมด detached (
-d) - ตั้งชื่อ container ว่า
redisเพื่อให้อ้างถึงได้ง่าย - เปิด Redis ที่ port มาตรฐาน 6379 ให้ NautilusTrader บนเครื่องเข้าถึงได้
การจัดการ Redis container:
- เริ่มด้วย
docker start redis - หยุดด้วย
docker stop redis
แนะนำให้ใช้ Redis Insight เป็น GUI เพื่อดูและ debug ข้อมูลใน Redis อย่างมีประสิทธิภาพ
Precision mode
NautilusTrader รองรับ precision mode สองแบบสำหรับ value type หลัก (Price, Quantity, Money)
ซึ่งต่างกันที่ความกว้างบิตภายในและจำนวนทศนิยมสูงสุด
- High-precision: integer 128 บิต ทศนิยมได้สูงสุด 16 ตำแหน่ง และช่วงค่ากว้างกว่า
- Standard-precision: integer 64 บิต ทศนิยมได้สูงสุด 9 ตำแหน่ง และช่วงค่าแคบกว่า
สำหรับ crate แบบ Rust ล้วน high-precision ทำงานได้บนทุกแพลตฟอร์ม (รวมถึง Windows) เพราะ Rust จัดการ
i128/u128 ด้วยการจำลองระดับ software ค่าเริ่มต้นคือ standard-precision เว้นแต่จะเปิด feature flag
high-precision อย่างชัดเจน
benchmark เปรียบเทียบประสิทธิภาพของทั้งสองโหมดยังอยู่ระหว่างจัดทำ
การตั้งค่า build
precision mode ถูกเลือกตอน compile ผ่าน Rust feature flag high-precision
Rust feature flag
หากต้องการเปิดโหมด high-precision (128 บิต) ใน Rust ให้เพิ่ม feature high-precision ลงใน Cargo.toml:
[dependencies]
nautilus-model = { version = "*", features = ["high-precision"] }ดูข้อกำหนดของ Value Types สำหรับรายละเอียดเพิ่มเติม
แปลจาก เอกสาร NautilusTrader © Nautech Systems Pty Ltd และผู้ร่วมพัฒนา เผยแพร่ภายใต้ LGPL-3.0 ฉบับแปลนี้ตัดเนื้อหาเฉพาะ Python ออกและเน้น Rust