Sediakan Aplikasi Node.js Menggunakan MySQL dan Prisma pada Raspberry Pi

Penggunaan aplikasi telah menjadi semakin mudah diakses, dengan pelbagai pilihan pengehosan percuma dan berbayar seperti Render, AWS dan DigitalOcean. Walau bagaimanapun, bagi pembangun yang ingin belajar, mencuba dan menggunakan aplikasi tanpa bayaran pengehosan berulang, Raspberry Pi menawarkan alternatif yang sangat baik. Peranti padat lagi berkuasa ini membolehkan anda mencipta pelayan berasaskan Linux anda sendiri untuk mengehos aplikasi web.

Dalam blog ini, kami akan meneroka cara untuk menggunakan aplikasi TypeScript Node.js menggunakan MySQL (MariaDB pada Raspberry Pi) dan Prisma ORM pada sebuah Raspberry Pi. Selain itu, kami akan mengkonfigurasi NGINX untuk proksi terbalik dan menggunakan Ngrok untuk mendedahkan aplikasi kepada internet. Mari selami!

---

Gambaran Keseluruhan Alat

Raspberry Pi

Kos rendah, komputer papan tunggal yang menjalankan sistem pengendalian berasaskan Linux. Ia sesuai untuk mencipta pelayan anda sendiri untuk IoT atau aplikasi web.

Node.js & TypeScript

Node.js ialah persekitaran masa jalan untuk melaksanakan JavaScript pada pelayan dan TypeScript menambah penaipan statik pada JavaScript, menjadikan pangkalan kod lebih boleh diselenggara.

MySQL (MariaDB pada Raspberry Pi)

Sistem pangkalan data hubungan yang popular, MariaDB ialah pengganti yang serasi untuk MySQL dan cukup ringan untuk Raspberry Pi.

Prisma ORM

Alat Object-Relational Mapping (ORM) yang memudahkan interaksi pangkalan data dengan bahasa pertanyaan selamat jenis dan migrasi skema.

NGINX

Pelayan HTTP berprestasi tinggi dan pelayan proksi terbalik. Ia membantu laluan trafik ke aplikasi Node.js anda.

Ngrok

Alat terowong yang mendedahkan aplikasi yang dihoskan tempatan anda kepada Internet dengan selamat tanpa konfigurasi rangkaian yang rumit.

---

Prasyarat

1. Raspberry Pi yang berfungsi - Pastikan SSH didayakan pada Raspberry Pi dan anda boleh mengaksesnya dari jauh.
2. Repositori Github - Aplikasi Node.js TypeScript anda hendaklah dihoskan dalam repositori GitHub untuk penggunaan mudah.
3. Akaun Ngrok - Buat akaun percuma di Ngrok untuk mendapatkan token pengesahan untuk mendedahkan apl Raspberry Pi anda kepada internet.

Menyediakan Raspberry Pi

1. Pasang OS

   Sediakan Raspberry Pi anda dengan OS seperti Raspberry Pi OS. Gunakan Raspberry Pi Imager untuk mencari OS lain yang serasi dengan Raspberry Pi anda.

2. Cari Alamat IP

   Gunakan alat seperti Pengimbas IP Marah untuk menemui alamat IP Raspberry Pi anda. Pastikan Raspberry Pi disambungkan ke rangkaian yang sama dengan mesin tempatan anda.

3. Semak Status Raspberry Pi
   

   ping <IP_ADDRESS_OF_RPI>
   

4. SSH Ke dalam Raspberry Pi
   

   ssh <username>@<IP_ADDRESS_OF_RPI>
   

   Ganti dengan nama pengguna Raspberry Pi anda dan dengan alamat IP dan kemudian masukkan kata laluan.

5. Kemas kini Sistem
   

   sudo apt update && sudo apt upgrade
   

6. Pasang Git

   Periksa sama ada git dipasang. Jika tidak, jalankan arahan di bawah untuk memasang git
   

   sudo apt install git
   

---

Memasang Node.js

Untuk memasang nod js, kami akan menggunakan nvm (Pengurus Versi Node). Ia membolehkan anda memasang dan menggunakan versi nod yang berbeza dengan pantas melalui baris arahan.

1. Pasang NVM
   

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
   

2. Sahkan Pemasangan
   

   nvm --version
   

3. Pasang Versi LTS Terkini Node.js
   

   nvm install --lts
   

4. Sahkan Pemasangan Node.js dan npm
   

   node --version
   # v22.12.0
   
   npm --version
   # 10.9.0
   

---

Menyediakan MySQL (MariaDB)

Untuk OS Raspberry Pi, kami akan memasang MariaDB.

1. Pasang MariaDB SQL Server
   

   sudo apt install mariadb-server
   

2. Pemasangan MariaDB Selamat
   

   sudo mysql_secure_installation
   

   Ikuti gesaan untuk melindungi pangkalan data anda.

   • Masukkan kata laluan akar semasa: - Tekan Enter apabila diminta memasukkan kata laluan semasa untuk pengguna akar (kerana ia belum ditetapkan lagi).
   • Tetapkan kata laluan akar: - Taip n apabila digesa untuk menetapkan kata laluan akar (kami akan menetapkannya kemudian).
   • Alih keluar pengguna tanpa nama: - Taip Y untuk mengalih keluar pengguna tanpa nama dan meningkatkan keselamatan. (Untuk tujuan ujian, anda boleh menaip n untuk mengekalkan pengguna tanpa nama.)
   • Larang log masuk akar dari jauh: - Taip n untuk membenarkan log masuk akar dari jauh (pilihan tetapi kurang selamat).
   • Alih keluar pangkalan data ujian: - Taip y untuk mengalih keluar pangkalan data ujian dan akses kepadanya. (Taip n jika anda ingin menyimpannya.)

3. Log masuk ke Pelanggan MariaDB
   

   sudo mysql
   

4. Sediakan kata laluan Root untuk MariaDB

   Pertama, kita perlu memberitahu pelayan pangkalan data untuk memuat semula jadual pemberian.
   

   MariaDB [(none)]> FLUSH PRIVILEGES;
   

   Tukar kata laluan akar dengan pertanyaan di bawah.
   

   MariaDB [(none)]> ALTER USER 'root'@'localhost' IDENTIFIED BY '<new_password>';
   

   Ganti dengan kata laluan anda sendiri.

   Gunakan arahan keluar untuk keluar daripada MariaDB CLI.
   

   MariaDB [(none)]> exit;
   Bye
   

5. Log masuk ke Pelanggan MariaDB Dengan Pengguna Root
   

   ping <IP_ADDRESS_OF_RPI>
   

   Masukkan kata laluan untuk pengguna root.

Menyediakan Pangkalan Data dan Pengguna

Mari buat pangkalan data baharu dan pengguna. Kami akan memberikan semua keistimewaan kepada pengguna baharu untuk pangkalan data baharu yang telah kami cipta.

1. Buat Pangkalan Data
   

   ssh <username>@<IP_ADDRESS_OF_RPI>
   

2. Buat Pengguna Baharu Dengan Kata Laluan
   

   sudo apt update && sudo apt upgrade
   

3. Berikan Keistimewaan Kepada Pengguna Baharu Dicipta
   

   sudo apt install git
   

4. Siram Jadual Keistimewaan
   

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
   

5. Keluar daripada klien mysql menggunakan arahan keluar.

6. Log Masuk Dengan Pengguna Baharu
   

   nvm --version
   

   Masukkan kata laluan yang anda gunakan semasa membuat pengguna.

7. Sahkan Pengguna Boleh Menyenaraikan Pangkalan Data
   

   nvm install --lts
   

Itu sahaja! Kami akan menggunakan pangkalan data dan pengguna ini dalam aplikasi kami.

---

Sediakan Aplikasi Node.js anda

1. Klon Repositori Github Anda
   

   node --version
   # v22.12.0
   
   npm --version
   # 10.9.0
   

2. Navigasi Ke Repositori Projek Anda
   

   sudo apt install mariadb-server
   

3. Pasang Kebergantungan Projek
   

   sudo mysql_secure_installation
   

4. Kompilkan TypeScript Code
   

   sudo mysql
   

Pastikan anda telah mengkonfigurasi sifat outDir dalam fail tsconfig.json anda. Ini menentukan direktori tempat kod JavaScript yang disusun akan dijana. Secara lalai, ia biasanya ditetapkan kepada dist, tetapi anda boleh menyesuaikannya berdasarkan struktur projek anda.

Menyediakan pembolehubah persekitaran (Pilihan)

Jika projek anda menggunakan pembolehubah persekitaran, anda perlu menetapkannya pada Raspberry Pi anda. Anda boleh mencipta fail .env dalam direktori akar projek anda untuk menyimpan semua pembolehubah persekitaran.

1. Buat Fail .env
   

   MariaDB [(none)]> FLUSH PRIVILEGES;
   

2. Kemas kini Fail .env
   

   MariaDB [(none)]> ALTER USER 'root'@'localhost' IDENTIFIED BY '<new_password>';
   

3. Masukkan Pembolehubah Persekitaran anda
   

   MariaDB [(none)]> exit;
   Bye
   

   Ganti , dan dengan yang anda buat dalam langkah sebelumnya.

   Simpan fail dengan menekan Ctrl O, kemudian tekan Enter, dan keluar dari editor menggunakan Ctrl X.

Berhijrah Skema Prisma

Jika anda menggunakan Prisma, semua fail skema akan terletak di dalam direktori prisma/skema. Kami kini akan menggunakan skema ini ke pangkalan data.

Jalankan arahan di bawah

sudo mysql -u root -p

Arahan ini akan menggunakan DATABASE_URL yang disediakan dalam fail .env untuk menggunakan skema ke pangkalan data. Anda boleh mengesahkan penggunaan dengan log masuk ke klien MySQL dan menggunakan arahan SHOW TABLES; untuk menyenaraikan semua jadual.

---

Menyediakan PM2

PM2 ialah pengurus proses pengeluaran untuk aplikasi Node.js yang membantu dalam mengurus dan memastikan aplikasi dalam talian. Pasang PM2 untuk mengurus aplikasi Node.js anda.

ping <IP_ADDRESS_OF_RPI>

---

Mengkonfigurasi NGINX

1. Pasang NGINX
   

   ssh <username>@<IP_ADDRESS_OF_RPI>
   

2. Buat Konfigurasi Tapak
   

   sudo apt update && sudo apt upgrade
   

3. Tambah Kod Di Bawah
   

   sudo apt install git
   

   Berikut ialah pecahan setiap bahagian:

   dengar 80; Arahan ini memberitahu NGINX untuk mendengar pada port 80, yang merupakan port lalai untuk trafik HTTP.

   nama_pelayan ; Ini menentukan nama domain atau alamat IP Raspberry Pi anda. Gantikan dengan alamat IP sebenar Raspberry Pi anda. NGINX akan membalas permintaan yang dihantar ke alamat ini.

   lokasi / { ... } Blok ini mentakrifkan cara NGINX harus mengendalikan permintaan ke URL akar (/). Pada asasnya, ini memberitahu NGINX bahawa setiap kali permintaan dibuat kepada akar, ia harus dimajukan ke hujung belakang (aplikasi Node.js anda) yang dijalankan pada port yang ditentukan.

   proxy_pass http://localhost:YOUR_NODE_JS_PORT; Ini ialah baris utama yang memajukan permintaan masuk ke aplikasi Node.js anda. Gantikan YOUR_NODE_JS_PORT dengan port sebenar tempat apl Node.js anda sedang berjalan (contohnya, 5000). Permintaan akan dihantar ke aplikasi Node.js yang berjalan pada mesin yang sama (localhost).

   proxy_http_version 1.1; Ini menetapkan versi HTTP kepada 1.1 untuk sambungan proksi, yang memastikan pengendalian ciri tertentu yang lebih baik seperti WebSockets.

   proxy_set_header Naik Taraf $http_upgrade; Pengepala ini membenarkan sambungan WebSocket dinaik taraf, yang penting untuk aplikasi masa nyata.

   proxy_set_header Sambungan 'naik taraf'; Pengepala ini digunakan bersama pengepala Naik Taraf untuk mengurus sambungan WebSocket, memastikan sambungan dinaik taraf dengan betul daripada HTTP ke WebSocket.

   proxy_set_header Hos $host; Ini menghantar pengepala Hos asal daripada permintaan pelanggan ke pelayan hujung belakang. Ini berguna untuk aplikasi yang bergantung pada pengepala Hos asal (cth., untuk penghalaan atau pengehosan maya).

   proxy_cache_bypass $http_upgrade; Ini memastikan sambungan WebSocket memintas sebarang mekanisme caching, membolehkan komunikasi masa nyata berfungsi tanpa gangguan daripada caching.

   Simpan fail dengan menekan Ctrl O, kemudian tekan Enter, dan keluar dari editor menggunakan Ctrl X.

4. Dayakan Konfigurasi Tapak
   

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
   

5. Uji Konfigurasi NGINX
   

   nvm --version
   

   Jika ujian berjaya, anda akan melihat sesuatu seperti di bawah:
   

   ping <IP_ADDRESS_OF_RPI>
   

6. Mulakan semula Pelayan NGINX Untuk Menggunakan Perubahan
   

   ssh <username>@<IP_ADDRESS_OF_RPI>
   

7. Semak Status Pelayan NGINX
   

   sudo apt update && sudo apt upgrade
   

---

Menjalankan Aplikasi

1. Navigasi ke projek anda

2. Mulakan Permohonan Anda Menggunakan PM2

   Jika anda telah menyediakan skrip dalam package.json, gunakan arahan di bawah:
   

   sudo apt install git
   

   Atau, anda boleh terus menjalankan aplikasi anda menggunakan fail index.js dalam direktori dist anda:
   

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
   

   Anda juga boleh menyemak log menggunakan arahan di bawah:
   

   nvm --version
   

Sekarang, semak apl anda dengan memasukkan alamat IP Raspberry Pi anda dalam penyemak imbas pada mesin tempatan anda. Ia sepatutnya berfungsi. Pastikan kedua-dua mesin tempatan anda dan Raspberry Pi disambungkan ke rangkaian yang sama; jika tidak, ia tidak akan berfungsi.

---

Mendedahkan Apl Anda Kepada Dunia Menggunakan Ngrok

Sekarang anda telah menggunakan apl anda ke Raspberry Pi, anda hanya boleh mengakses apl daripada rangkaian yang sama di mana Raspberry Pi sedang dijalankan. Untuk mendedahkannya kepada internet, kita perlu menggunakan pemajuan port.

Anda boleh menyediakan pemajuan port menggunakan tetapan penghala anda, tetapi dalam kes ini, saya akan menggunakan ngrok. Ngrok berguna untuk pembangunan, membolehkan kami menjalankan apl kami untuk tujuan ujian secara percuma.

Pastikan anda membuat akaun dengan melawati https://dashboard.ngrok.com/login. Anda memerlukan token pengesahan untuk mengkonfigurasi ngrok pada Raspberry Pi.

1. Pasang Ngrok
   

   nvm install --lts
   

2. Tambahkan token pengesahan anda pada fail konfigurasi ngrok
   

   node --version
   # v22.12.0
   
   npm --version
   # 10.9.0
   

3. Lumpuhkan fail konfigurasi nginx lalai
   

   sudo apt install mariadb-server
   

4. Uji konfigurasi NGINX
   

   sudo mysql_secure_installation
   

5. Mulakan semula pelayan NGINX untuk menggunakan perubahan
   

   sudo mysql
   

6. Gunakan apl anda dalam talian
   

   MariaDB [(none)]> FLUSH PRIVILEGES;
   

   Ini sepatutnya menyediakan URL seperti https://xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx.ngrok-free.app/ yang memajukan trafik ke apl Node.js anda. Anda boleh menavigasi ke URL ini dari mana-mana rangkaian lain dan mengakses aplikasi anda.

---

Ringkasan

Dalam panduan ini, kami berjaya menggunakan aplikasi TypeScript Node.js dengan MySQL dan Prisma pada Raspberry Pi. Kami mengkonfigurasi NGINX sebagai proksi terbalik dan menggunakan Ngrok untuk menjadikan aplikasi boleh diakses melalui internet. Dengan persediaan ini, anda mempunyai pelayan pembangunan dihoskan sendiri yang menjimatkan kos anda sendiri.

Pendekatan ini sesuai untuk belajar dan bereksperimen dengan penggunaan aplikasi tindanan penuh, sambil memperoleh pengalaman berharga dalam pengurusan pelayan.

Beri tahu saya jika anda menggunakan aplikasi anda menggunakan panduan ini—saya ingin mendengar tentang pengalaman anda! ?

Atas ialah kandungan terperinci Sediakan Aplikasi Node.js Menggunakan MySQL dan Prisma pada Raspberry Pi. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!