Ubuntu VPS پر FreshRSS کیسے انسٹال کریں
Ubuntu 24.04 پر FreshRSS انسٹال کرنے کا مکمل طریقہ۔ Apache، PHP اور MariaDB کے ساتھ ڈیٹا بیس سیٹ اپ، cron job کنفیگریشن اور موبائل API کے لیے ضروری مراحل یہاں موجود ہیں۔
آپ کیا بنا رہے ہیں
Self-hosted RSS reader وہ feed reader ہے جو آپ کے اپنے server پر چلتا ہے، اس لیے کوئی اسے بند نہیں کر سکتا یا اس میں دکھائی جانے والی معلومات تبدیل نہیں کر سکتا۔ اس guide میں FreshRSS کو Ubuntu 24.04 VPS پر نصب کیا جاتا ہے: سامنے Apache، اس کے پیچھے PHP، data storage کے لیے MariaDB، اور نئی articles حاصل کرنے کے لیے ایک cron job۔ RSS (really simple syndication) وہ file format ہے جسے کوئی site شائع کرتی ہے تاکہ software اس کی articles پڑھ سکے۔ FreshRSS وہ PHP application ہے جو ان files کو جمع کرتی ہے، articles محفوظ رکھتی ہے، اور web interface کے علاوہ ایک API (application programming interface) فراہم کرتی ہے جس سے phone apps رابطہ کرتی ہیں۔
نصب کا بنیادی عمل مختصر ہے: ایک release کو unpack کریں، database بنائیں، ایک virtual host لکھیں، command line installer چلائیں، پھر cli/create-user.php کے ذریعے account بنائیں۔ ذیل میں زیادہ تر کام ان مسائل سے متعلق ہے جو لوگ بعد میں پیدا کرتے ہیں: refresh job، mobile API کے لیے encoded slashes، اور file ownership۔
FreshRSS 1.30.4، جو October 21, 2026 کو شائع ہوا، October 29, 2026 تک موجودہ release ہے، اور اسے PHP 8.1 یا اس کے بعد کا ورژن درکار ہے۔ Ubuntu 24.04 کے ساتھ PHP 8.3 فراہم ہوتا ہے، اس لیے distribution packages کافی ہیں اور آپ کو third-party PHP repository کی ضرورت نہیں۔
ایک فعال LAMP اسٹیک سے شروعات کریں
FreshRSS ایک عام PHP ایپلی کیشن ہے، لہذا اسے کسی بھی دوسری ایپلی کیشن کی طرح بنیادی ڈھانچے کی ضرورت ہوتی ہے۔ اگر آپ نے ابھی تک یہ بنیاد تیار نہیں کی ہے، تو پہلے Ubuntu 24.04 کے لیے LAMP اسٹیک سیٹ اپ کی پیروی کریں اور پھر یہاں واپس آئیں۔ مختصر ورژن یہ ہے:
sudo apt update
sudo apt install -y apache2 mariadb-server php libapache2-mod-php
sudo systemctl enable --now apache2 mariadbsystemctl status apache2 کو active (running) رپورٹ کرنا چاہیے۔ اگر Apache شروع نہیں ہوتا ہے، تو اس کی عام وجہ یہ ہوتی ہے کہ کوئی دوسرا عمل پہلے سے port 80 استعمال کر رہا ہے، اور sudo ss -ltnp | grep :80 اس کا نام ظاہر کر دے گا۔
FreshRSS کے لیے درکار PHP ایکسٹینشنز
FreshRSS کے لیے libxml، cURL، JSON، PDO_MySQL، PCRE اور ctype لازمی ہیں۔ یہ mbstring، iconv، Zlib، ZipArchive اور 32 بٹ سسٹم پر GMP کا بھی تقاضا کرتا ہے۔ Ubuntu پر یہ ڈسٹری بیوشن پیکجز کے طور پر دستیاب ہوتے ہیں:
sudo apt install -y php-curl php-mbstring php-xml php-zip php-mysql php-intl php-gmp
sudo systemctl restart apache2یہ چیک کریں کہ PHP نے درحقیقت کیا لوڈ کیا ہے، اس کے لیے php -m استعمال کریں۔ کسی ایکسٹینشن کی عدم موجودگی انسٹالر کو شروع ہونے سے نہیں روکتی۔ یہ اسے ریکوائرمنٹس اسکرین پر ایک سرخ لائن کے ساتھ روک دیتی ہے جس میں ایکسٹینشن کا نام درج ہوتا ہے، جو کہ مسئلہ دریافت کرنے کے لیے ایک الجھا دینے والی جگہ ہے، لہذا ابھی تصدیق کر لیں۔ Apache کو ری اسٹارٹ کرنا ضروری ہے کیونکہ libapache2-mod-php، PHP کو Apache پروسیس کے اندر رکھتا ہے، اس لیے نئی انسٹال کردہ ایکسٹینشن ویب سرور کے ری اسٹارٹ ہونے تک نظر نہیں آتی۔
ریلیز ڈاؤن لوڈ کریں
FreshRSS کو پہلے سے طے شدہ web root کے باہر انسٹال کریں اور Apache کو اس کی طرف point کریں۔ application directory کو document root سے الگ رکھنے کا مطلب ہے کہ HTTP کے ذریعے صرف public folder قابل رسائی ہوگا۔
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اب permissions مقرر کریں، جن کے بارے میں FreshRSS documentation سخت تقاضے رکھتی ہے: web server user پورے tree کا مالک ہو، group ہر file کو read کر سکے، اور group کو ./data/ میں write کرنے کی اجازت ہو۔
sudo chown -R www-data:www-data /srv/freshrss
sudo chmod -R g+r /srv/freshrss
sudo chmod -R g+w /srv/freshrss/dataاگر یہ مرحلہ چھوڑ دیا جائے تو installer اپنی configuration لکھتے وقت fail ہو جاتا ہے، کیونکہ PHP بطور www-data چلتا ہے اور www-data root کی ملکیت والی directory میں write نہیں کر سکتا۔
ڈیٹابیس بنائیں
FreshRSS، SQLite، MariaDB، MySQL اور PostgreSQL کو سپورٹ کرتا ہے۔ SQLite کے لیے php-sqlite3 extension درکار ہے، لیکن database server کی setup درکار نہیں ہوتی، اور یہ ہر صارف کا ڈیٹا الگ data/users/_user_/db.sqlite file میں محفوظ کرتا ہے۔ صارفین شامل کرنے سے ان کی writes ایک مشترکہ SQLite file میں نہیں جاتیں؛ اس guide میں LAMP stack کے حصے کے طور پر MariaDB استعمال کیا گیا ہے۔
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;"utf8mb4 استعمال کریں، utf8 نہیں۔ Feeds میں emoji اور non-Latin scripts شامل ہو سکتے ہیں، جبکہ پرانی three byte utf8 encoding four byte characters محفوظ نہیں کر سکتی۔ Unsupported characters، MariaDB کے default strict mode میں error پیدا کرتے ہیں؛ truncation کا انحصار SQL mode اور IGNORE جیسے statement options پر ہوتا ہے۔
Apache ورچوئل ہوسٹ
عوامی ڈائریکٹری p/ ہے، نہ کہ ٹری کا اوپری حصہ۔ باقی تمام چیزیں، بشمول وہ کنفیگریشن فائل جس میں آپ کے ڈیٹا بیس کا پاس ورڈ موجود ہے، ڈاکومنٹ روٹ سے اوپر موجود ہوتی ہیں جہاں Apache اسے کبھی بھی سرو (serve) نہیں کرے گا۔
<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>اسے /etc/apache2/sites-available/freshrss.conf کے طور پر محفوظ کریں اور اسے فعال کریں:
sudo a2enmod rewrite
sudo a2ensite freshrss
sudo a2dissite 000-default
sudo apache2ctl configtest
sudo systemctl reload apache2configtest کو Syntax OK پرنٹ کرنا چاہیے۔ AllowEncodedSlashes On اختیاری معلوم ہوتا ہے لیکن یہ نہیں ہے: Google Reader API ایسے فیڈ شناخت کنندگان بھیجتا ہے جن میں %2F شامل ہوتا ہے، اور اس ہدایت کے بغیر Apache انہیں مسترد کر دیتا ہے، جس کی وجہ سے موبائل ایپس سنک (sync) ہونے میں ناکام ہو جاتی ہیں جبکہ ویب انٹرفیس بالکل درست کام کرتا ہے۔
لاگ ان کرنے سے پہلے HTTPS شامل کریں
آپ اس سائٹ پر پاس ورڈ درج کرنے والے ہیں، لہذا پہلے ایک سرٹیفکیٹ حاصل کریں۔ سرور پر ایک A record پوائنٹ کریں، پھر Ubuntu پر Apache کے لیے Certbot سیٹ اپ پر عمل کریں اور sudo certbot --apache -d rss.example.com چلائیں۔ Certbot پورٹ 443 کے لیے ورچوئل ہوسٹ کو دوبارہ لکھتا ہے اور ری ڈائریکٹ شامل کرتا ہے۔ curl -I https://rss.example.com/ کے ساتھ تصدیق کریں، جسے 200 یا لاگ ان صفحہ پر ری ڈائریکٹ واپس کرنا چاہیے۔
کمانڈ لائن سے انسٹالر چلائیں
FreshRSS میں براؤزر پر مبنی انسٹالر موجود ہے، لیکن کمانڈ لائن ورژن کو دہرایا جا سکتا ہے اور یہ اس بات کا ریکارڈ رکھتا ہے کہ آپ نے کیا منتخب کیا ہے۔
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'دونوں کو www-data کے طور پر چلائیں۔ انہیں root کے طور پر چلانے سے ایسی کنفیگریشن فائلیں بنتی ہیں جن کا مالک root ہوتا ہے، اور بعد میں ویب انٹرفیس کوئی بھی سیٹنگ محفوظ کرنے میں ناکام ہو جاتا ہے۔ --environment production بھی اہم ہے، کیونکہ ڈیولپمنٹ سیٹنگ صفحے پر PHP نوٹس پرنٹ کرتی ہے۔
https://rss.example.com/ لوڈ کریں اور admin کے طور پر لاگ ان کریں۔
فیڈ خود بخود کیوں تازہ نہیں ہوتے
جب تک آپ ہدایت نہ دیں، کوئی عمل آپ کے فیڈز کو poll نہیں کرتا۔ FreshRSS کھولنے سے فیڈ fetch کرنے کا schedule نہیں بنتا؛ scheduler کے بغیر مضامین دستی طور پر fetch کرنے کے لیے navigation menu میں موجود update link استعمال کریں۔ اس کا حل وہ script ہے جو project نے اسی مقصد کے لیے فراہم کی ہے، app/actualize_script.php، جسے cron سے چلایا جاتا ہے۔
sudo crontab -u www-data -eایک سطر شامل کریں:
*/20 * * * * php /srv/freshrss/app/actualize_script.php > /tmp/FreshRSS.log 2>&1بیس منٹ کا schedule مناسب ہے، لیکن ہر فیڈ کا refresh interval پھر بھی لاگو ہوتا ہے: default ایک گھنٹہ ہے، جبکہ انفرادی فیڈز پندرہ منٹ تک کے interval کو support کرتی ہیں۔ پہلے اسے ہاتھ سے ایک بار چلائیں:
sudo -u www-data php /srv/freshrss/app/actualize_script.phpدرست output میں refresh run کی اطلاع آتی ہے اور عمل PHP error کے بغیر ختم ہوتا ہے؛ جب مضامین شامل یا update کیے جائیں تو فیڈ کے نام ظاہر ہوتے ہیں۔ اگر بالکل کوئی output نہ آئے تو PHP کی error output اور FreshRSS logs چیک کریں؛ صرف خاموشی کی بنیاد پر یہ نتیجہ نہ نکالیں کہ وجہ cron user ہے۔ data/ پر permission error کی صورت میں ownership اور write permissions چیک کریں۔
اپنی پہلی فیڈز شامل کریں
انٹرفیس کے اوپری بائیں کونے میں موجود پلس بٹن کا استعمال کریں، کسی سائٹ کا ایڈریس پیسٹ کریں، اور FreshRSS خود بخود آپ کے لیے فیڈ لنک تلاش کر لے گا۔ زیادہ تر سائٹس اب بھی فیڈ شائع کرتی ہیں، تب بھی جب وہ اس کی تشہیر نہیں کرتیں، عام طور پر /feed، /rss یا /atom.xml پر۔ کیٹیگریز فولڈرز کی طرح ہوتی ہیں، اور ان کے درمیان فیڈ کو منتقل کرنا ڈریگ اینڈ ڈراپ کے ذریعے ممکن ہے۔
اگر آپ کسی دوسرے ریڈر سے آ رہے ہیں، تو وہاں سے ایک OPML فائل ایکسپورٹ کریں اور اسے سبسکرپشن مینجمنٹ کے صفحے پر امپورٹ کریں۔ OPML (آؤٹ لائن پروسیسر مارک اپ لینگویج) فیڈ لسٹ کا معیاری فارمیٹ ہے، اور ہر وہ ریڈر جسے چھوڑنے کے قابل سمجھا جائے، اسے سپورٹ کرتا ہے۔ ایک بڑی امپورٹ پہلی ریفریش پر سست ہوتی ہے کیونکہ ہر فیڈ کو ایک بار فیچ کیا جاتا ہے، لہذا رفتار کا اندازہ لگانے سے پہلے پہلے cron رن کو مکمل ہونے کا وقت دیں۔
اپنے فون پر پڑھیں
FreshRSS، Google Reader API کے ساتھ کام کرتا ہے، جسے RSS کی بہت سی ایپس support کرتی ہیں۔ دو شرائط پوری ہونی چاہئیں۔ authentication settings میں "Allow API access" فعال ہونا چاہیے؛ اوپر موجود --api-enabled flag نے اسے پہلے ہی فعال کر دیا ہے۔ آپ کے profile میں API password field میں کوئی value ہونی چاہیے۔ یہ آپ کے login password سے جان بوجھ کر الگ ہے، کیونکہ فون کے گم ہونے کا امکان زیادہ ہوتا ہے۔
server configuration checks خودکار طور پر چلانے کے لیے https://rss.example.com/api/ کھولیں۔ درست setup کی صورت میں PASS ظاہر ہوتا ہے۔ اگر check ناکام ہو جائے تو virtual host کی AllowEncodedSlashes On setting اور رپورٹ کردہ error دیکھیں۔ ایپ میں server address کے طور پر https://rss.example.com/api/greader.php، username کے طور پر اپنا FreshRSS user، اور password کے طور پر API password درج کریں۔
Docker کا متبادل
اگر آپ PHP اور Apache کو دستی طور پر برقرار نہیں رکھنا چاہتے، تو پروجیکٹ ایک باضابطہ freshrss/freshrss امیج شائع کرتا ہے، اور ایک compose فائل آپ کو ایپلیکیشن اور اس کا ڈیٹا بیس ایک ساتھ فراہم کرتی ہے۔ اس کا سودا معمول کے مطابق ہے: ہوسٹ پر کم متحرک پرزے، خرابی کی صورت میں ڈیبگ کرنے کے لیے ایک اضافی تہہ، اور TLS (transport layer security) کے لیے اب بھی ایک ریورس پراکسی کی ضرورت ہے۔ اگر یہ آپ کے لیے زیادہ موزوں ہے، تو VPS کے لیے Docker Compose کی بنیادی باتیں فائل فارمیٹ کا احاطہ کرتی ہیں، اور cron لائن docker exec --user www-data freshrss php ./app/actualize_script.php بن جاتی ہے۔
بیک اپس اور اپ گریڈز
آپ کی state دو چیزیں محفوظ رکھتی ہیں: database اور /srv/freshrss/data/۔ پہلی چیز کا dump sudo mysqldump freshrss > freshrss.sql سے بنائیں، دوسری کی copy بنائیں، اور دونوں کو اس server کے علاوہ کسی اور جگہ محفوظ رکھیں۔ آپ کی subscription list کا کبھی کبھار OPML export بھی مفید ہے، کیونکہ یہ file آپ کی feed list کو OPML سپورٹ کرنے والے دوسرے readers میں منتقل کر دیتی ہے۔ اس میں FreshRSS کی مخصوص settings، مثلاً refresh frequency، credentials، user agent یا XPath web scraping rules محفوظ نہیں ہوتیں؛ انہیں بھی محفوظ رکھنے کے لیے SQLite export استعمال کریں۔
اپ گریڈ کے لیے اسی directory میں نئی release unpack کریں اور ownership commands دوبارہ چلائیں۔ Project کے version-by-version upgrade path پر عمل کریں اور ہر مرحلے کے بعد FreshRSS کی تصدیق کریں۔ FreshRSS اگلے page load پر اپنی database migrations خود لاگو کرتا ہے۔ پہلے backup بنائیں، کیونکہ ایسی database پر ناکام migration جسے آپ restore نہیں کر سکتے، ناقابلِ تلافی صورتِ حال پیدا کر دیتی ہے۔ اگر آپ نے 1.29.1 جیسی پرانی tarball سے installation کی ہے تو 1.30.4 پر منتقل ہوں: 1.30.x کی security releases میں authentication changes کے وقت session ID rotation اور ZIP imports کے لیے bounds شامل ہیں، جبکہ 1.30.4 شدید PHP vulnerabilities کے لیے متبادل Alpine Docker images بھی update کرتا ہے۔ Reader ایک کم خطرے والی service ہے اور اگر آپ self-hosting کے قابل چیزوں کی فہرست پر کام کر رہے ہیں تو یہ ایک اچھا ابتدائی انتخاب ہے۔
FAQ
میری feeds صرف FreshRSS کھولنے پر update کیوں ہوتی ہیں؟
صفحہ کھولنے سے feed fetching schedule نہیں ہوتی۔ Scheduler کے بغیر feeds کو manually refresh کرنے کے لیے update link استعمال کریں۔ app/actualize_script.php کو www-data user کے طور پر چلانے والی cron line شامل کریں، پھر script کو ایک بار ہاتھ سے چلائیں اور اس کا output پڑھیں۔ اگر output خاموش ہو تو PHP کی error output اور FreshRSS logs دیکھیں۔ اس کے بعد تصدیق کریں کہ cron user کو data/ پر write access حاصل ہے۔
میری mobile app connect نہیں کر سکتی، لیکن website کام کرتی ہے۔ کیوں؟
Google Reader API request paths کے اندر encoded slashes (%2F) استعمال کرتی ہے، اور Apache انہیں default طور پر reject کرتا ہے۔ virtual host کے اندر AllowEncodedSlashes On شامل کریں اور Apache reload کریں۔ https://rss.example.com/api/ کھول کر fix کی تصدیق کریں۔ وہاں automatic configuration check کو PASS report کرنا چاہیے۔ یہ بھی دیکھیں کہ API password آپ کے profile میں set ہے، کیونکہ یہ login password سے الگ ہوتا ہے۔
مجھے SQLite استعمال کرنا چاہیے یا MariaDB؟
SQLite کو php-sqlite3 extension درکار ہوتی ہے، لیکن کسی database server یا database password کو manage کرنے کی ضرورت نہیں ہوتی۔ ہر user کو الگ SQLite database file ملتی ہے۔ اس لیے دوسرے user کو شامل کرنے سے ایک shared file پر contention پیدا نہیں ہوتی اور MariaDB کی ضرورت بھی نہیں پڑتی۔ اگر آپ اپنے LAMP stack میں database server استعمال کرنا چاہتے ہیں تو MariaDB استعمال کریں۔ بعد میں دونوں کے درمیان منتقل ہونا export اور import commands کے ذریعے ممکن ہے، اس لیے یہ مستقل فیصلہ نہیں ہے۔
Installer اپنی configuration لکھتے وقت fail ہو جاتا ہے۔ مسئلہ کیا ہے؟
Apache کے تحت PHP، www-data کے طور پر چلتا ہے، اور اس user کو root کی ملکیت والی directory میں write کرنے کی اجازت نہیں ہوتی۔ sudo chown -R www-data:www-data /srv/freshrss اور sudo chmod -R g+w /srv/freshrss/data دوبارہ چلائیں، پھر installer دوبارہ شروع کریں۔ اگر آپ پہلے ہی command line installer کو root کے طور پر چلا چکے ہیں تو دوبارہ کوشش سے پہلے data/ کے تحت اس کے بنائے ہوئے files کی ownership درست کریں۔
ایک self-hosted RSS reader کو کتنے server resources درکار ہوتے ہیں؟
بہت کم۔ FreshRSS محدود hardware پر چلنے کے لیے بنایا گیا ہے، لیکن resource usage آپ کی feeds، article sizes اور retention settings پر منحصر ہوتی ہے۔ Retention کے ساتھ disk usage بڑھتا ہے۔ اس لیے ہر چیز ہمیشہ رکھنے کے بجائے archiving settings میں article purge policy set کریں۔