Stirling-PDF – (prawie) idealne narzędzie do edycji tych zasranych PDF-ów, które nie chcą się dać edytować
Stirling-PDF to open-source'owe narzędzie, które robi z PDF-ami (prawie) wszystko, czego możesz potrzebować. Jest ładnie, jest responsywnie, jest lokalnie. Słowem, jest bardzo sympatycznie. I cyk, kolejny fakulec leci w stronę Adobe (a tfu).
Stirling-PDF jest świetny
Stirling-PDF to open-source’owe narzędzie, które robi z PDF-ami (prawie) wszystko, czego możesz potrzebować. Jest ładnie, jest responsywnie, jest lokalnie. Słowem, jest bardzo sympatycznie.
I cyk, kolejny fakulec leci w stronę Adobe (a tfu).
Co potrafi Stirling-PDF
Podstawowe operacje:
- Łączenie i dzielenie PDF-ów
- Obracanie stron
- Wyciąganie konkretnych stron
- Zmiana kolejności stron
Bardziej zaawansowane rzeczy:
- Konwersja z/do różnych formatów (Word, Excel, obrazki)
- OCR - czyli rozpoznawanie tekstu z zeskanowanych dokumentów (obsługuje polski!)
- Kompresja PDF-ów
- Dodawanie/usuwanie watermarków
- Podpisywanie cyfrowe dokumentów
- Szyfrowanie i zabezpieczanie hasłem
I jeszcze kilka smaczków:
- Dodawanie numeracji stron
- Czyszczenie metadanych
- Nakładanie PDF-ów na siebie
- Auto-split według rozmiaru/ilości stron
Wszystko to pakuje się w przyzwoite, responsywne UI, które działa zarówno na komputerze, jak i telefonie.
Daj się edytować, ty głupi PDF-ie
Nie zliczę ile razy musiałem na szybko poprawić literówkę albo jakieś dane do faktury. W takich momentach wciąż muszę sięgać po inne narzędzia albo (co robię najczęściej) eksportować do Worda, poprawiać i generować PDF-a od nowa.
Self-hosted Stirling-PDF na świetnym, bo polskim Mikrusie
Moment, w którym zrzucasz kajdany założone przez chciwego hostingodawcę gównianego, współdzielonego hostingu, to niewątpliwie przełomowa chwila w życiu człowieka.
Nagle cały wirtualny świat stoi przed Tobą otworem, a jedynym ograniczeniem jest Twoja wyobraźnia. Czujesz w żyłach buzującą adrenalinę, a w oddali dociera do Ciebie syreni śpiew komend Linuxa. Pora założyć rękawiczki, zdjąć spodenki i wpisać tajemne, elfie runy ssh…
3 godziny i 88 komend później zamykasz terminal, idziesz na spacer i rozważasz zostanie mobilnym masażystą.
Ta przezabawna, wręcz komediowo genialna wstawka powyżej nijak ma się naturalnie do rzeczywistości i jeśli tylko potrafisz czytać i chociaż raz widziałeś terminal na oczy, bez problemu ogarniesz (szczególnie teraz, kiedy w zasadzie nawet czytać nie musisz, bo wszystko robi za ciebie LLM).
A jeśli używasz Mikrusa, to sprawa jest jeszcze prostsza, bo sporo rzeczy masz już tam out of the box.
Czym jest Mikrus?
Jak sam twórca (Jakub Mrugalski) pisze, Mikrus to Serwery VPS dla pasjonatów.
I to czuć.
Największymi zaletami Mikrusa są dla mnie:
- Działa, jak ma działać.
- Cena.
- Aktywna i nietoksyczna społeczność (wspomnianych wcześniej pasjonatów).
- Jakkolwiek dziwnie to zabrzmi, to poczucie przyzwoitości stojące za całym przedsięwzięciem.
Za minus możesz uznać brzydkie UI dostępnego panelu, no ale biorąc VPS-a, piszesz się raczej na korzystanie z terminala.
Instalujemy Stirling-PDF
Najprościej self-hostować Stirling-PDF przy pomocy Dockera. Upewnij się zatem, czy twoja wersja Mikrusa ma to narzędzie i jedziemy z tematem.
Krok po kroku:
- Zaloguj się do serwera po
ssh - Stwórz katalog
mkdir -p ~/stirling-pdfi przejdź do niegocd ~/stirling-pdf - Stwórz
docker-composeprzeznano docker-compose.yml - Wklej config:
services: stirling-pdf: image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest container_name: stirling-pdf ports: - '8080:8080' volumes: - ./trainingData:/usr/share/tessdata # OCR language data - ./extraConfigs:/configs # Custom configs - ./customFiles:/customFiles/ # User files - ./logs:/logs/ # Application logs - ./pipeline:/pipeline/ # Processing pipelines
environment: - DOCKER_ENABLE_SECURITY=false - DISABLE_ADDITIONAL_FEATURES=false - LANGS=en_GB,pl_PL restart: unless-stopped- Zapisz i wyjdź z
nano:Ctrl+X, Y, Enter - Odpal kontener:
docker compose up -d - Jeśli wszystko poszło ok, to powinno pojawić się coś w stylu
Started StirlingPdfApplication
Weryfikacja:
Sprawdź czy Stirling śmiga przy pomocy:
curl http://localhost:8080/api/v1/info/statusJak zobaczysz coś w stylu {"status":"UP"}, to mamy to.
Dostęp do Stirlinga
Ja potrzebowałem Stirlinga do spięcia z n8n, które jest postawione na tym samym Mikrusie. Dlatego do moich potrzeb wystarczyło przekazanie endpointu lokalnie: http://localhost:8080/api/v1/convert/pdf/img
Jeśli chciałbyś dostać się do panelu z przeglądarki, musisz:
- Otworzyć port w panelu Mikrusa (zakładka “Porty TCP”)
- Zmienić mapping portów w
docker-compose.yml:
ports: - '40116:8080' # lub inny wybrany port zewnętrznySchemat jest prosty: PORT_ZEWNĘTRZNY:PORT_KONTENERA
Gdzie:
- 40116 (lub inny) - port, przez który łączysz się z internetu
- 8080 - port wewnętrzny, na którym Stirling nasłuchuje w kontenerze
- Zrestartuj kontener:
docker compose downdocker compose up -dTeraz możesz wejść do Stirlinga przez: http://srv32.mikr.us:40116 (lub twój adres i port)
Podsumowanie
Stirling-PDF to solidne narzędzie do PDF-ów, które możesz mieć u siebie, całkowicie pod swoją kontrolą. Odpalasz, używasz, działa.
Czy jest idealny? Nie - brak bezpośredniej edycji tekstu boli. Ale do wszystkiego innego jest naprawdę spoko. A jak jeszcze dorzucisz do tego fakt, że możesz go postawić na Mikrusie za grosze, to wychodzi całkiem przyjemny setup.
Polecam potestować, do następnego!
Przydatne linki: