Cara Pasang FreshRSS pada VPS Ubuntu 24.04
Pasang FreshRSS 1.30.1 pada VPS Ubuntu 24.04 dengan Apache, PHP 8.1+, MariaDB, virtual host, cron penyegaran dan API aplikasi mudah alih.
Apa yang anda sedang bina
Pembaca RSS yang dihoskan sendiri (self-hosted) ialah pembaca suapan yang berjalan pada pelayan milik anda, supaya tiada pihak boleh menutupnya atau mengubah kandungan yang dipaparkan kepada anda. Panduan ini memasang FreshRSS pada VPS Ubuntu 24.04: Apache di hadapan, PHP di belakangnya, MariaDB untuk storan, dan satu cron job yang mengambil artikel baharu. RSS (really simple syndication) ialah format fail yang diterbitkan oleh sesebuah laman supaya perisian boleh membaca artikelnya. FreshRSS ialah aplikasi PHP yang mengumpul fail tersebut, menyimpan artikel, dan menyediakan antara muka web serta API (application programming interface) yang digunakan oleh aplikasi telefon.
Pemasangan itu sendiri kecil: nyahzip satu release, cipta pangkalan data, tulis satu virtual host, jalankan pemasang baris perintah, kemudian cipta akaun dengan cli/create-user.php. Kebanyakan kerja di bawah adalah bahagian yang sering disalah buat oleh pengguna selepas itu, iaitu tugas penyegaran (refresh job), slash yang dikodkan untuk API mudah alih, dan pemilikan fail.
FreshRSS 1.30.4, yang diterbitkan pada 21 Oktober 2026, merupakan release semasa setakat 29 Oktober 2026, dan ia memerlukan PHP 8.1 atau lebih baharu. Ubuntu 24.04 membekalkan PHP 8.3, jadi pakej pengedaran sudah mencukupi dan anda tidak memerlukan repositori PHP pihak ketiga.
Mulakan dengan tindanan LAMP yang berfungsi
FreshRSS ialah aplikasi PHP biasa, jadi aplikasi ini memerlukan asas yang sama seperti aplikasi lain. Jika anda belum menyediakan asas tersebut, ikuti persediaan tindanan LAMP untuk Ubuntu 24.04 terlebih dahulu, kemudian kembali ke sini. Ringkasnya:
sudo apt update
sudo apt install -y apache2 mariadb-server php libapache2-mod-php
sudo systemctl enable --now apache2 mariadbsystemctl status apache2 sepatutnya melaporkan active (running). Jika Apache tidak dapat dimulakan, punca yang lazim ialah proses lain sedang menggunakan port 80, dan sudo ss -ltnp | grep :80 mengenal pastinya.
Sambungan PHP yang diperlukan oleh FreshRSS
FreshRSS menganggap libxml, cURL, JSON, PDO_MySQL, PCRE dan ctype sebagai wajib. FreshRSS juga memerlukan mbstring, iconv, Zlib dan ZipArchive, serta GMP pada sistem 32 bit. Di Ubuntu, sambungan ini tersedia sebagai pakej pengedaran:
sudo apt install -y php-curl php-mbstring php-xml php-zip php-mysql php-intl php-gmp
sudo systemctl restart apache2Semak sambungan yang benar-benar dimuatkan oleh PHP menggunakan php -m. Sambungan yang tiada tidak menghalang pemasang daripada bermula. Sebaliknya, pemasang akan berhenti pada skrin keperluan dan memaparkan baris merah yang menamakan sambungan tersebut. Menemui masalah pada peringkat itu boleh mengelirukan, jadi sahkan sekarang. Memulakan semula Apache penting kerana libapache2-mod-php menjalankan PHP dalam proses Apache. Oleh itu, pelayan web tidak akan melihat sambungan yang baru dipasang sehingga Apache dimulakan semula.
Muat turun release
Pasang FreshRSS di luar web root lalai, dan halakan Apache kepadanya. Mengekalkan direktori aplikasi berasingan daripada document root bermakna hanya folder public yang boleh dicapai melalui HTTP.
cd /tmp
curl -fsSLO https://github.com/FreshRSS/FreshRSS/archive/refs/tags/1.30.4.tar.gz
tar xzf 1.30.4.tar.gz
sudo mv FreshRSS-1.30.4 /srv/freshrssSekarang tetapkan keizinan (permissions), yang mana dokumentasi FreshRSS sangat tegas mengenainya: pengguna pelayan web memiliki pepohon direktori, kumpulan boleh membaca setiap fail, dan kumpulan boleh menulis ke ./data/.
sudo chown -R www-data:www-data /srv/freshrss
sudo chmod -R g+r /srv/freshrss
sudo chmod -R g+w /srv/freshrss/dataLangkau langkah ini dan pemasang akan gagal semasa menulis konfigurasinya, kerana PHP berjalan sebagai www-data dan www-data tidak boleh menulis ke dalam direktori yang dimiliki oleh root.
Cipta pangkalan data
FreshRSS menyokong SQLite, MariaDB, MySQL dan PostgreSQL. SQLite memerlukan sambungan php-sqlite3 tetapi tidak memerlukan penyediaan pelayan pangkalan data, dan menyimpan data setiap pengguna dalam fail data/users/_user_/db.sqlite yang berasingan. Menambah pengguna tidak akan memasukkan penulisan mereka ke dalam satu fail SQLite yang dikongsi; panduan ini menggunakan MariaDB sebagai sebahagian daripada tindanan LAMP.
sudo mariadb -e "CREATE DATABASE freshrss CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
sudo mariadb -e "CREATE USER 'freshrss'@'localhost' IDENTIFIED BY 'ReplaceThisPassword';"
sudo mariadb -e "GRANT ALL PRIVILEGES ON freshrss.* TO 'freshrss'@'localhost';"
sudo mariadb -e "FLUSH PRIVILEGES;"Gunakan utf8mb4 dan bukan utf8. Suapan (feeds) membawa emoji dan skrip bukan Latin, dan pengekodan utf8 tiga bait yang lama tidak dapat menyimpan aksara empat bait. Aksara yang tidak disokong akan menyebabkan ralat di bawah mod ketat (strict mode) lalai MariaDB; pemotongan (truncation) bergantung pada mod SQL dan pilihan pernyataan seperti IGNORE.
Hos maya Apache
Direktori awam ialah p/, bukan bahagian teratas pepohon direktori. Semua yang lain, termasuk fail konfigurasi yang menyimpan kata laluan pangkalan data anda, berada di atas akar dokumen dan tidak akan disampaikan oleh Apache.
<VirtualHost *:80>
ServerName rss.example.com
DocumentRoot /srv/freshrss/p/
<Directory /srv/freshrss/p>
AllowOverride AuthConfig FileInfo Indexes Limit
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/freshrss_error.log
CustomLog ${APACHE_LOG_DIR}/freshrss_access.log combined
AllowEncodedSlashes On
</VirtualHost>Simpan konfigurasi itu sebagai /etc/apache2/sites-available/freshrss.conf dan dayakannya:
sudo a2enmod rewrite
sudo a2ensite freshrss
sudo a2dissite 000-default
sudo apache2ctl configtest
sudo systemctl reload apache2configtest sepatutnya memaparkan Syntax OK. AllowEncodedSlashes On kelihatan seperti pilihan dan sebenarnya tidak: Google Reader API menghantar pengecam suapan yang mengandungi %2F, dan tanpa arahan ini Apache menolaknya. Akibatnya, aplikasi mudah alih gagal menyegerak walaupun antara muka web berfungsi dengan sempurna.
Tambah HTTPS sebelum anda log masuk
Anda akan memasukkan kata laluan ke dalam tapak ini, jadi dapatkan sijil terlebih dahulu. Halakan rekod A ke pelayan, kemudian ikuti persediaan Certbot untuk Apache pada Ubuntu dan jalankan sudo certbot --apache -d rss.example.com. Certbot menulis semula hos maya untuk port 443 dan menambah pengalihan. Sahkan dengan curl -I https://rss.example.com/, yang sepatutnya mengembalikan 200 atau mengalihkan ke halaman log masuk.
Jalankan pemasang daripada baris perintah
FreshRSS mempunyai pemasang melalui pelayar, tetapi versi baris perintah boleh diulang dan merekodkan dengan tepat pilihan anda.
sudo -u www-data php /srv/freshrss/cli/do-install.php \
--default-user admin --auth-type form --environment production \
--base-url https://rss.example.com --language en --api-enabled \
--db-type mysql --db-host localhost --db-user freshrss \
--db-password 'ReplaceThisPassword' --db-base freshrss
sudo -u www-data php /srv/freshrss/cli/create-user.php \
--user admin --password 'a-long-passphrase' --api-password 'a-different-passphrase'Jalankan kedua-duanya sebagai www-data. Menjalankannya sebagai root akan mencipta fail konfigurasi yang dimiliki oleh root, dan antara muka web kemudiannya gagal menyimpan sebarang tetapan. --environment production juga penting kerana tetapan pembangunan mencetak notis PHP pada halaman.
Muatkan https://rss.example.com/ dan log masuk sebagai admin.
Mengapa suapan tidak dikemas kini secara automatik
Tiada proses yang melakukan polling pada suapan anda sehingga anda menetapkannya. Membuka FreshRSS tidak menjadualkan pengambilan suapan; tanpa penjadual, gunakan pautan kemas kini dalam menu navigasi untuk mengambil artikel secara manual. Penyelesaiannya ialah skrip yang dibekalkan oleh projek ini, app/actualize_script.php, yang dijalankan melalui cron.
sudo crontab -u www-data -eTambah satu baris:
*/20 * * * * php /srv/freshrss/app/actualize_script.php > /tmp/FreshRSS.log 2>&1Dua puluh minit ialah jadual yang munasabah, namun selang masa muat semula setiap suapan masih terpakai: lalai ialah satu jam, dan suapan individu menyokong selang masa sehingga lima belas minit. Jalankan skrip tersebut sekali secara manual terlebih dahulu:
sudo -u www-data php /srv/freshrss/app/actualize_script.phpOutput yang sihat akan melaporkan proses muat semula dan berakhir tanpa ralat PHP; nama suapan akan muncul apabila artikel ditambah atau dikemas kini. Jika ia tidak mencetak apa-apa, semak output ralat PHP dan log FreshRSS; kesunyian sahaja tidak mengenal pasti pengguna cron sebagai puncanya. Ralat kebenaran pada data/ memerlukan pemeriksaan pemilikan dan kebenaran tulis.
Tambah suapan pertama anda
Gunakan butang tambah di bahagian atas kiri antara muka, tampal alamat tapak, dan FreshRSS akan menemukan pautan suapan untuk anda. Kebanyakan tapak masih menerbitkan suapan walaupun tidak mengiklankannya, biasanya di /feed, /rss atau /atom.xml. Kategori ialah folder, dan anda boleh memindahkan suapan antara kategori dengan menyeretnya.
Jika anda datang daripada pembaca lain, eksport fail OPML di situ dan import fail tersebut pada halaman pengurusan langganan. OPML (outline processor markup language) ialah format senarai suapan standard, dan setiap pembaca yang wajar digunakan menyokongnya. Import yang besar akan menjadi perlahan semasa penyegaran pertama kerana setiap suapan diambil sekali. Oleh itu, berikan masa kepada pelaksanaan cron pertama sebelum menilai kelajuannya.
Baca pada telefon anda
FreshRSS menyokong API Google Reader yang digunakan oleh banyak aplikasi RSS. Dua syarat perlu dipenuhi. Di bawah tetapan pengesahan, "Allow API access" mesti diaktifkan, yang telah ditetapkan oleh flag --api-enabled di atas. Di bawah profil anda, medan API password mesti mengandungi nilai, dan ia sengaja diasingkan daripada kata laluan log masuk anda kerana peranti telefon lebih mudah hilang.
Lawati https://rss.example.com/api/ untuk menjalankan semakan konfigurasi pelayan secara automatik. Persediaan yang berfungsi akan memaparkan PASS. Jika semakan gagal, periksa tetapan AllowEncodedSlashes On pada virtual host dan ralat yang dilaporkan. Dalam aplikasi, masukkan alamat pelayan sebagai https://rss.example.com/api/greader.php, nama pengguna sebagai pengguna FreshRSS anda, dan API password sebagai kata laluan.
Alternatif Docker
Jika anda tidak mahu menyelenggara PHP dan Apache secara manual, projek ini menerbitkan imej freshrss/freshrss rasmi. Satu fail compose menyediakan aplikasi dan pangkalan datanya bersama-sama. Pertukarannya adalah seperti biasa: lebih sedikit komponen untuk diurus pada hos, satu lagi lapisan untuk dinyahpepijat apabila berlaku masalah, dan proksi terbalik masih diperlukan untuk TLS (keselamatan lapisan pengangkutan). Jika pilihan ini lebih sesuai untuk anda, asas Docker Compose untuk VPS menerangkan format fail tersebut, dan baris cron menjadi docker exec --user www-data freshrss php ./app/actualize_script.php.
Sandaran dan peningkatan
Dua perkara menyimpan keadaan anda: pangkalan data dan /srv/freshrss/data/. Buat dump perkara pertama dengan sudo mysqldump freshrss > freshrss.sql, salin perkara kedua, dan simpan kedua-duanya di lokasi selain pelayan ini. Senarai langganan anda juga wajar dieksport ke OPML sekali-sekala kerana fail itu boleh memindahkan senarai suapan anda ke pembaca lain yang menyokong OPML. Fail tersebut tidak menyimpan tetapan khusus FreshRSS seperti kekerapan penyegaran, kelayakan, user agent atau peraturan web scraping XPath; gunakan eksport SQLite untuk menyimpan tetapan itu juga.
Proses peningkatan ialah mengekstrak release yang lebih baharu ke direktori yang sama dan menjalankan semula arahan pemilikan. Ikuti laluan peningkatan projek mengikut versi dan sahkan FreshRSS selepas setiap langkah. FreshRSS menggunakan migrasi pangkalan datanya sendiri apabila halaman dimuatkan seterusnya. Buat sandaran dahulu kerana migrasi yang gagal pada pangkalan data yang tidak boleh dipulihkan akan menyebabkan keadaan yang tidak boleh dipulihkan. Jika anda memasang daripada tarball lama seperti 1.29.1, naik taraf kepada 1.30.4: release keselamatan 1.30.x menyertakan penggiliran ID sesi apabila pengesahan berubah serta had pada import ZIP, manakala 1.30.4 turut mengemas kini imej Alpine Docker alternatif untuk menangani kerentanan PHP yang serius. Pembaca ialah servis berisiko rendah untuk dijalankan dan calon pertama yang baik jika anda sedang meneliti senarai perkara yang berbaloi untuk dihoskan sendiri.
FAQ
Mengapakah suapan saya hanya dikemas kini apabila saya membuka FreshRSS?
Membuka halaman tidak menjadualkan pengambilan suapan; tanpa penjadual, gunakan pautan kemas kini untuk memuat semula secara manual. Tambahkan baris cron yang memanggil app/actualize_script.php sebagai pengguna www-data, kemudian jalankan skrip tersebut secara manual sekali dan baca keluarannya. Jika tiada output, semak keluaran ralat PHP dan log FreshRSS, kemudian sahkan bahawa pengguna cron mempunyai akses tulis ke data/.
Aplikasi mudah alih saya tidak dapat bersambung, tetapi laman web berfungsi. Mengapa?
Google Reader API meletakkan garis miring berkod (%2F) di dalam laluan permintaan, dan Apache menolak perkara tersebut secara lalai. Tambahkan AllowEncodedSlashes On di dalam virtual host dan muat semula Apache. Sahkan pembaikan dengan membuka https://rss.example.com/api/, di mana semakan konfigurasi automatik sepatutnya melaporkan PASS. Pastikan juga kata laluan API telah ditetapkan dalam profil anda, kerana ia berbeza daripada kata laluan log masuk anda.
Patutkah saya menggunakan SQLite atau MariaDB?
SQLite memerlukan sambungan php-sqlite3, tetapi tidak memerlukan pelayan pangkalan data atau kata laluan pangkalan data untuk diuruskan. Setiap pengguna mendapat fail pangkalan data SQLite yang berasingan, jadi menambah pengguna kedua tidak mewujudkan pertikaian pada satu fail kongsi atau memerlukan MariaDB. Gunakan MariaDB jika anda ingin menggunakan pelayan pangkalan data dalam stack LAMP anda. Peralihan antara kedua-duanya boleh dilakukan kemudian melalui arahan eksport dan import, jadi ini bukanlah keputusan kekal.
Pemasang gagal apabila ia menulis konfigurasinya. Apakah masalahnya?
PHP berjalan sebagai www-data di bawah Apache, dan pengguna tersebut tidak boleh menulis ke dalam direktori yang dimiliki oleh root. Jalankan semula sudo chown -R www-data:www-data /srv/freshrss dan sudo chmod -R g+w /srv/freshrss/data, kemudian mulakan pemasang sekali lagi. Jika anda telah menjalankan pemasang baris arahan sebagai root, betulkan pemilikan fail yang diciptanya di bawah data/ sebelum mencuba semula.
Berapakah keperluan pelayan untuk pembaca RSS yang dihoskan sendiri?
Sangat sedikit. FreshRSS direka untuk berjalan pada perkakasan yang sederhana, tetapi penggunaan sumber bergantung pada suapan, saiz artikel dan tetapan pengekalan anda. Penggunaan cakera meningkat mengikut pengekalan, jadi tetapkan polisi pembersihan artikel dalam tetapan pengarkiban daripada menyimpan segala-galanya selama-lamanya.