SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor

Jinsi ya kusakinisha FreshRSS kwenye Ubuntu VPS

Jifunze kusakinisha FreshRSS kwenye Ubuntu 24.04 kwa kutumia Apache, PHP 8.3 na MariaDB. Mwongozo huu unashughulikia usanidi wa cron job, virtual host na API ya simu kwa usahihi.

Unachojenga

RSS reader inayojiendesha (self-hosted) ni kisoma-feed kinachoendeshwa kwenye seva unayomiliki, hivyo hakuna mtu anayeweza kuizima au kubadilisha kile inachokuonyesha. Mwongozo huu unaweka FreshRSS kwenye Ubuntu 24.04 VPS: Apache mbele, PHP nyuma yake, MariaDB kwa ajili ya hifadhi, na cron job moja inayochota makala mpya. RSS (Really Simple Syndication) ni umbizo la faili ambalo tovuti huchapisha ili programu iweze kusoma makala zake. FreshRSS ni programu ya PHP inayokusanya faili hizo, kuhifadhi makala, na kukupa kiolesura cha wavuti pamoja na API (Application Programming Interface) ambayo programu za simu hutumia.

Ufungaji wenyewe ni mdogo: fungua release, tengeneza database, andika virtual host moja, endesha kisakinishi cha mstari wa amri (command line), kisha tengeneza akaunti kwa kutumia cli/create-user.php. Kazi nyingi hapa chini ni sehemu ambayo watu hukosea baadaye, ambayo ni kazi ya kusasisha (refresh job), slashes zilizosimbwa kwa ajili ya API ya simu, na umiliki wa faili.

FreshRSS 1.30.4, iliyochapishwa tarehe 21 Oktoba 2026, ndiyo release ya sasa kufikia tarehe 29 Oktoba 2026, na inahitaji PHP 8.1 au mpya zaidi. Ubuntu 24.04 inakuja na PHP 8.3, kwa hivyo vifurushi vya usambazaji (distribution packages) vinatosha na huhitaji hazina (repository) ya PHP ya mtu wa tatu.

Anza na LAMP stack inayofanya kazi

FreshRSS ni programu ya kawaida ya PHP, kwa hivyo inahitaji msingi uleule kama programu nyingine yoyote. Ikiwa bado hujajenga msingi huo, fuata usanidi wa LAMP stack kwa Ubuntu 24.04 kwanza kisha urudi hapa. Toleo fupi:

sudo apt update
sudo apt install -y apache2 mariadb-server php libapache2-mod-php
sudo systemctl enable --now apache2 mariadb

systemctl status apache2 inapaswa kutoa taarifa ya active (running). Ikiwa Apache itakataa kuanza, sababu ya kawaida ni mchakato mwingine ambao tayari unashikilia port 80, na sudo ss -ltnp | grep :80 itautaja mchakato huo.

Viendelezi vya PHP vinavyohitajika na FreshRSS

FreshRSS inachukulia libxml, cURL, JSON, PDO_MySQL, PCRE na ctype kama vitu vya lazima. Pia inahitaji mbstring, iconv, Zlib na ZipArchive, pamoja na GMP kwenye mfumo wa 32-bit. Kwenye Ubuntu, hivi vinapatikana kama vifurushi vya usambazaji:

sudo apt install -y php-curl php-mbstring php-xml php-zip php-mysql php-intl php-gmp
sudo systemctl restart apache2

Thibitisha ni viendelezi vipi vya PHP vilivyopakiwa kwa kutumia php -m. Kiendelezi kinachokosekana hakizuii kisakinishi kuanza. Kinakizuia kwenye skrini ya mahitaji kwa mstari mwekundu unaotaja kiendelezi hicho, hali inayoweza kuchanganya unapogundua tatizo, kwa hivyo thibitisha sasa. Kuanzisha upya Apache ni muhimu kwa sababu libapache2-mod-php huweka PHP ndani ya mchakato wa Apache, hivyo kiendelezi kipya kilichosakinishwa hakitaonekana na seva ya wavuti hadi itakapoanzishwa upya.

Pakua toleo la programu

Sakinisha FreshRSS nje ya saraka ya msingi ya wavuti (web root), kisha uelekeze Apache kwenye saraka hiyo. Kuweka saraka ya programu kando na document root kunahakikisha kuwa folda ya umma pekee ndiyo inayoweza kufikiwa kupitia 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/freshrss

Sasa ni zamu ya ruhusa (permissions), ambazo nyaraka za FreshRSS huzisisitiza sana: mtumiaji wa seva ya wavuti anapaswa kumiliki mti wa saraka, kundi (group) liweze kusoma kila faili, na kundi liweze kuandika kwenye ./data/.

sudo chown -R www-data:www-data /srv/freshrss
sudo chmod -R g+r /srv/freshrss
sudo chmod -R g+w /srv/freshrss/data

Ukikwepa hatua hii, kisakinishi kitashindwa kuandika usanidi wake, kwa sababu PHP huendeshwa kama www-data na www-data haiwezi kuandika kwenye saraka inayomilikiwa na root.

Unda hifadhidata

FreshRSS inasaidia SQLite, MariaDB, MySQL na PostgreSQL. SQLite inahitaji kiendelezi cha php-sqlite3 lakini haihitaji usanidi wa seva ya hifadhidata, na huhifadhi data ya kila mtumiaji kwenye faili tofauti ya data/users/_user_/db.sqlite. Kuongeza watumiaji hakuhifadhi maandishi yao kwenye faili moja ya pamoja ya SQLite; mwongozo huu unatumia MariaDB kama sehemu ya LAMP stack.

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;"

Tumia utf8mb4 na si utf8. Feeds hubeba emoji na maandishi yasiyo ya Kilatini, na mfumo wa zamani wa encoding wa baiti tatu wa utf8 hauwezi kuhifadhi vibambo vya baiti nne. Vibambo visivyotumika husababisha hitilafu chini ya hali ya strict mode ya MariaDB; kufupishwa kwa data hutegemea SQL mode na chaguzi za taarifa kama vile IGNORE.

Virtual host ya Apache

Saraka ya umma ni p/, si sehemu ya juu ya mti wa faili. Kila kitu kingine, ikiwemo faili la usanidi lenye nenosiri la database yako, hukaa juu ya document root ambapo Apache haitakihudumia kamwe.

<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>

Hifadhi hiyo kama /etc/apache2/sites-available/freshrss.conf na uiwezeshe:

sudo a2enmod rewrite
sudo a2ensite freshrss
sudo a2dissite 000-default
sudo apache2ctl configtest
sudo systemctl reload apache2

configtest inapaswa kuonyesha Syntax OK. AllowEncodedSlashes On inaonekana kama ya hiari lakini si hivyo: Google Reader API hutuma vitambulishi vya feed vyenye %2F, na bila maelekezo haya Apache huvikataa, hivyo programu za simu hushindwa kusawazisha (sync) wakati interface ya wavuti ikifanya kazi kikamilifu.

Ongeza HTTPS kabla ya kuingia kwenye mfumo

Unakaribia kuingiza nenosiri kwenye tovuti hii, kwa hivyo pata cheti kwanza. Elekeza A record kwenye seva, kisha fuata usanidi wa Certbot kwa Apache kwenye Ubuntu na uendeshe sudo certbot --apache -d rss.example.com. Certbot huandika upya virtual host kwa ajili ya port 443 na kuongeza redirect. Thibitisha kwa curl -I https://rss.example.com/, ambayo inapaswa kurejesha 200 au kuelekeza kwenye ukurasa wa kuingia.

Endesha kisakinishi kupitia mstari wa amri

FreshRSS ina kisakinishi cha kivinjari, lakini toleo la mstari wa amri linaweza kurudiwa na huacha kumbukumbu kamili ya chaguo ulizofanya.

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'

Endesha zote mbili kama www-data. Kuziendesha kama root hutengeneza faili za usanidi zinazomilikiwa na root, na kiolesura cha wavuti kitashindwa kuhifadhi mipangilio yoyote baadaye. --environment production ni muhimu pia, kwa sababu mpangilio wa development huchapisha notisi za PHP kwenye ukurasa.

Pakia https://rss.example.com/ na uingie kama admin.

Kwa nini feeds hazijisasishi zenyewe

Hakuna kinachofanya polling ya feeds zako hadi utakapokiamuru. Kufungua FreshRSS hakupangi ratiba ya kuchota feeds; bila scheduler, tumia link ya update iliyo kwenye menyu ya navigation ili kuchota makala kwa mikono. Suluhisho ni script ambayo mradi huu inatoa kwa ajili ya kazi hii, app/actualize_script.php, inayotekelezwa kupitia cron.

sudo crontab -u www-data -e

Ongeza mstari mmoja:

*/20 * * * * php /srv/freshrss/app/actualize_script.php > /tmp/FreshRSS.log 2>&1

Dakika 20 ni ratiba inayofaa, lakini muda wa refresh wa kila feed bado unazingatiwa: muda wa kawaida ni saa moja, na feeds binafsi zinaweza kuwekwa hadi dakika kumi na tano. Iendeshe mara moja kwa mikono kwanza:

sudo -u www-data php /srv/freshrss/app/actualize_script.php

Output yenye afya inaripoti utekelezaji wa refresh na kuishia bila error ya PHP; majina ya feeds huonekana pale makala zinapoongezwa au kusasishwa. Ikiwa haitoi chochote, kagua output ya error ya PHP na logs za FreshRSS; ukimya pekee hautoshi kubaini kama mtumiaji wa cron ndiye chanzo cha tatizo. Error ya permission kwenye data/ inahitaji ukaguzi wa umiliki na ruhusa za kuandika (write permissions).

Ongeza feeds zako za kwanza

Tumia kitufe cha kujumlisha kilicho upande wa juu kushoto wa kiolesura, bandika anwani ya tovuti, na FreshRSS itakutafutia kiungo cha feed. Tovuti nyingi bado huchapisha feed hata kama hazitangazi, kwa kawaida kwenye /feed, /rss au /atom.xml. Kategoria ni folda, na kuhamisha feed kati ya kategoria hizo ni rahisi kwa kuburuta.

Ikiwa unatoka kwenye kisomaji kingine, hamisha faili ya OPML kutoka huko na uingize kwenye ukurasa wa usimamizi wa usajili. OPML (outline processor markup language) ndiyo fomati ya kawaida ya orodha ya feeds, na kila kisomaji kinachofaa kutumiwa kinaunga mkono fomati hii. Uingizaji mkubwa wa data huwa polepole wakati wa refresh ya kwanza kwa sababu kila feed huchotwa mara moja, kwa hivyo ipe muda cron run ya kwanza kabla ya kuhukumu kasi yake.

Isome kwenye simu yako

FreshRSS inatumia Google Reader API, ambayo inaungwa mkono na programu nyingi za RSS. Mambo mawili lazima yatimie. Chini ya mipangilio ya uthibitishaji (authentication settings), "Allow API access" lazima iwe imewashwa, jambo ambalo flag ya --api-enabled hapo juu tayari imetekeleza. Chini ya wasifu wako (profile), sehemu ya neno la siri la API (API password) lazima iwe na thamani, na neno hili ni tofauti kimakusudi na neno lako la siri la kuingia (login password) kwa sababu simu ni kifaa ambacho ni rahisi kupotea.

Tembelea https://rss.example.com/api/ ili kuendesha ukaguzi wa usanidi wa seva kiotomatiki. Usanidi unaofanya kazi vizuri hurejesha PASS. Ikiwa ukaguzi utafeli, kagua mpangilio wa AllowEncodedSlashes On wa virtual host na kosa lililoripotiwa. Kwenye programu, ingiza anwani ya seva kama https://rss.example.com/api/greader.php, jina la mtumiaji kama mtumiaji wako wa FreshRSS, na neno la siri la API kama neno la siri.

Mbadala wa Docker

Ikiwa ungependelea kutotunza PHP na Apache kwa mikono, mradi huu hutoa image rasmi ya freshrss/freshrss, na faili moja ya compose hukupa programu hiyo pamoja na database yake. Makubaliano ni yale ya kawaida: vipengele vichache vinavyohitaji matunzo kwenye host, safu moja zaidi ya kutatua matatizo (debug) kitu kinapoharibika, na bado unahitaji reverse proxy kwa ajili ya TLS (transport layer security). Ikiwa hilo linakufaa zaidi, misingi ya Docker Compose kwa VPS inashughulikia muundo wa faili, na mstari wa cron unakuwa docker exec --user www-data freshrss php ./app/actualize_script.php.

Hifadhi nakala na uboreshaji

Vitu viwili vinashikilia hali yako: hifadhidata, na /srv/freshrss/data/. Toa nakala ya kwanza kwa kutumia sudo mysqldump freshrss > freshrss.sql, nakili ya pili, na uweke zote mahali pengine nje ya seva hii. Orodha yako ya usajili pia inafaa kusafirishwa mara kwa mara kama OPML, kwa sababu faili hiyo huhamisha orodha yako ya feed kwenda kwa visomaji vingine vinavyotumia OPML. Haisahihishi mipangilio mahususi ya FreshRSS kama vile marudio ya kusasisha, vitambulisho, user agent au sheria za XPath za kuchota data kwenye wavuti; tumia usafirishaji wa SQLite kuhifadhi hayo pia.

Uboreshaji ni kufungua release mpya juu ya saraka ileile na kuendesha tena amri za umiliki. Fuata njia ya uboreshaji ya toleo-kwa-toleo ya mradi na uthibitishe FreshRSS baada ya kila hatua. FreshRSS hutumia migrations zake za hifadhidata wakati wa kupakia ukurasa unaofuata. Hifadhi nakala kwanza, kwa sababu migration iliyoshindwa kwenye hifadhidata ambayo huwezi kuirejesha ni hali isiyoweza kutatulika. Ikiwa uliweka kutoka kwa tarball ya zamani kama 1.29.1, hamia 1.30.4: releases za usalama za 1.30.x zinajumuisha mzunguko wa session ID wakati wa mabadiliko ya uthibitishaji na mipaka kwenye uingizaji wa ZIP, wakati 1.30.4 pia inasasisha picha mbadala za Alpine Docker kwa ajili ya udhaifu mkubwa wa PHP. Msomaji ni huduma ya hatari ndogo ya kuendesha na mgombea mzuri wa kwanza ikiwa unafanya kazi kupitia orodha ya kile kinachostahili kujihostia.

FAQ

Kwa nini feeds zangu husasishwa tu ninapofungua FreshRSS?

Kufungua ukurasa hakupangi ratiba ya kuchota feeds; bila scheduler, tumia link ya kusasisha ili kufanya hivyo kwa mikono. Ongeza mstari wa cron unaoita app/actualize_script.php kama mtumiaji www-data, kisha endesha script hiyo kwa mikono mara moja na usome matokeo yake. Ikiwa kimya, kagua matokeo ya makosa ya PHP na logs za FreshRSS, kisha thibitisha kuwa mtumiaji wa cron ana ruhusa ya kuandika kwenye data/.

App yangu ya simu haiwezi kuunganishwa, lakini tovuti inafanya kazi. Kwa nini?

Google Reader API huweka slashes zilizosimbwa (%2F) ndani ya njia za ombi, na Apache hukataa hizo kwa chaguo-msingi. Ongeza AllowEncodedSlashes On ndani ya virtual host na uanzishe upya Apache. Thibitisha marekebisho kwa kufungua https://rss.example.com/api/, ambapo ukaguzi wa usanidi wa kiotomatiki unapaswa kuripoti PASS. Pia hakikisha kuwa nenosiri la API limewekwa kwenye profile yako, kwa sababu ni tofauti na nenosiri lako la kuingia.

Je, nitumie SQLite au MariaDB?

SQLite inahitaji extension ya php-sqlite3, lakini haina seva ya database au nenosiri la database la kusimamia. Kila mtumiaji hupata faili tofauti ya database ya SQLite, kwa hivyo kuongeza mtumiaji wa pili hakusababishi mgogoro kwenye faili moja iliyoshirikiwa wala kuhitaji MariaDB. Tumia MariaDB ikiwa unataka kutumia seva ya database katika LAMP stack yako. Kuhama kati ya hizo mbili baadaye inawezekana kupitia amri za export na import, kwa hivyo hii si uamuzi wa kudumu.

Kisakinishi kinashindwa wakati kinaandika usanidi wake. Nini tatizo?

PHP huendeshwa kama www-data chini ya Apache, na mtumiaji huyo hawezi kuandika kwenye saraka inayomilikiwa na root. Endesha tena sudo chown -R www-data:www-data /srv/freshrss na sudo chmod -R g+w /srv/freshrss/data, kisha anza kisakinishi tena. Ikiwa tayari uliendesha kisakinishi cha mstari wa amri kama root, sahihisha umiliki wa faili ilizounda chini ya data/ kabla ya kujaribu tena.

Msomaji wa RSS anayejiendesha mwenyewe anahitaji seva ya ukubwa gani?

Kidogo sana. FreshRSS imeundwa kufanya kazi kwenye vifaa vya kawaida, lakini matumizi ya rasilimali hutegemea feeds zako, ukubwa wa makala, na mipangilio ya kuhifadhi. Disk hukua kulingana na muda wa kuhifadhi, kwa hivyo weka sera ya kufuta makala kwenye mipangilio ya archiving badala ya kuhifadhi kila kitu milele.

Je, makala hii ilikusaidia?