getce.pl

Jak uruchomić plik jar linux – praktyczny poradnik krok po kroku

Autor: Michał Wysocki12 min czytania
Laptop z otwartym terminalem stoi na biurku obok pendrive’a i żółtej karteczki z napisem Run Jar
0
(0)

Plik JAR może zawierać aplikację, serwer gry, narzędzie biznesowe albo bibliotekę Java. W systemie Linux samo dwukrotne kliknięcie często jednak nie wystarcza: potrzebne jest środowisko Java, poprawna ścieżka do pliku oraz informacja, którą klasę należy uruchomić. Najpewniejszą metodą pozostaje terminal, ponieważ pokazuje dokładny komunikat błędu zamiast po prostu nie reagować.

W tym poradniku przejdziesz od sprawdzenia instalacji Javy do uruchomienia aplikacji z parametrami, utworzenia skrótu graficznego i uruchomienia procesu na serwerze VPS. Polecenia są odpowiednie przede wszystkim dla Ubuntu, Debiana i Linux Mint, ale większość z nich działa także w innych dystrybucjach.

Cel Podstawowe polecenie lub rozwiązanie
Sprawdzenie Javy java -version
Uruchomienie pliku java -jar aplikacja.jar
Uruchomienie z pełną ścieżką java -jar /ścieżka/do/aplikacja.jar
Praca w tle nohup java -jar aplikacja.jar > aplikacja.log 2>&1 &
Podejrzenie procesu pgrep -af java

Co to jest plik JAR i do czego służy

JAR, czyli Java Archive, jest archiwum używanym przez aplikacje napisane w Javie. Technicznie przypomina plik ZIP: może zawierać skompilowane klasy, biblioteki, konfigurację, grafiki oraz plik manifestu. Nie każdy JAR jest jednak samodzielnym programem. Część takich plików pełni wyłącznie funkcję biblioteki wykorzystywanej przez inną aplikację.

Aby uruchomić program, system potrzebuje środowiska Java Runtime Environment. W praktyce użytkownik najczęściej instaluje pakiet OpenJDK, który dostarcza maszynę wirtualną Java i potrzebne komponenty uruchomieniowe. Nie trzeba instalować całego środowiska programistycznego, jeśli tylko korzystasz z gotowej aplikacji.

Warto rozróżnić dwa pakiety:

Pakiet Do czego służy Kiedy go wybrać
JRE Uruchamia aplikacje Java. Gdy korzystasz z gotowego pliku JAR.
JDK Zawiera środowisko uruchomieniowe oraz narzędzia do tworzenia i kompilowania programów. Gdy tworzysz, kompilujesz lub diagnozujesz aplikację Java.

Ważną rolę odgrywa plik META-INF/MANIFEST.MF. Jeżeli JAR ma działać po użyciu komendy java -jar, manifest zwykle musi zawierać wpis Main-Class. Wskazuje on klasę główną, od której należy rozpocząć działanie programu. Jeżeli tego wpisu brakuje, aplikacja może być poprawnym archiwum, ale nie będzie samodzielnie uruchamialnym programem.

Istotna różnica: plik JAR nie musi mieć uprawnienia wykonywania, aby uruchomić go przez java -jar. Liczy się dostęp Javy do odczytu pliku oraz możliwość wejścia do katalogu, w którym się znajduje. Dodanie chmod +x nie naprawi braku klasy głównej ani niezgodnej wersji środowiska.

Sprawdź i zainstaluj środowisko Java w systemie Linux

Zanim zmienisz skojarzenia plików albo utworzysz skrót, sprawdź, czy system widzi Javę. Otwórz terminal i wpisz:

java -version

Prawidłowy wynik zawiera numer wersji, na przykład 17, 21 albo inną wersję obsługiwaną przez aplikację. Jeśli pojawi się komunikat command not found lub podobny, Java nie jest zainstalowana albo jej plik wykonywalny nie znajduje się w zmiennej PATH.

W Ubuntu, Debianie i Linux Mint możesz zainstalować środowisko poleceniami:

sudo apt update
sudo apt install default-jre

Pakiet default-jre jest wygodnym wyborem, kiedy nie znasz jeszcze wymagań aplikacji. Jeżeli producent wyraźnie wymaga konkretnej wersji, użyj odpowiedniego pakietu, o ile jest dostępny w repozytorium, na przykład:

sudo apt install openjdk-17-jre
sudo apt install openjdk-21-jre

Numer powinien odpowiadać dokumentacji programu. Nowsza Java nie zawsze zastępuje starszą bez problemów, szczególnie w przypadku starszych aplikacji, serwerów gier i narzędzi korzystających z nieaktualnych bibliotek.

Do samego uruchamiania aplikacji zwykle wystarczy JRE. Pakiet JDK wybierz wtedy, gdy instrukcja wymaga komendy javac, aplikacja jest kompilowana lokalnie albo chcesz analizować zawartość i budować własne pliki JAR:

sudo apt install openjdk-21-jdk

Na serwerze bez interfejsu graficznego można zastosować wariant headless:

sudo apt install openjdk-21-jre-headless

Tryb headless nie zawiera elementów potrzebnych do wyświetlania okien, fontów czy obsługi części funkcji graficznych. Jest dobrym wyborem dla aplikacji serwerowych, które działają wyłącznie w terminalu. Dla programu desktopowego z oknem może być niewystarczający.

W innych popularnych dystrybucjach nazwy pakietów wyglądają inaczej:

Dystrybucja Przykładowa instalacja
Fedora sudo dnf install java-21-openjdk
Arch Linux sudo pacman -S jre-openjdk

Po instalacji ponownie wykonaj java -version. Jeśli masz kilka wersji Javy, sprawdź, która jest domyślna:

which java
update-alternatives --config java

Drugie polecenie dotyczy głównie dystrybucji bazujących na Debianie. Zmiana domyślnej wersji wpływa na inne programy korzystające z Javy, dlatego nie wykonuj jej bez potrzeby. Najpierw sprawdź wymagania konkretnej aplikacji.

Uruchomienie pliku JAR z wiersza poleceń

Terminal jest najlepszym punktem startowym, ponieważ od razu pokaże, czy problem dotyczy Javy, ścieżki, uprawnień czy samej aplikacji. Załóżmy, że plik nazywa się aplikacja.jar i znajduje się w bieżącym katalogu. Uruchomisz go tak:

java -jar aplikacja.jar

Jeżeli plik leży w katalogu Pobrane, przejdź do tego katalogu:

cd ~/Pobrane
java -jar aplikacja.jar

Możesz też użyć pełnej ścieżki bez zmiany katalogu:

java -jar /home/uzytkownik/Pobrane/aplikacja.jar

Zastąp uzytkownik własną nazwą konta. Ścieżki zawierające spacje trzeba ująć w cudzysłów:

java -jar "/home/uzytkownik/Moje aplikacje/aplikacja.jar"

To rozróżnienie jest ważne, ponieważ aplikacja może korzystać z plików konfiguracyjnych, grafik albo bibliotek zapisanych względem katalogu roboczego. Sam JAR uruchomi się z dowolnej lokalizacji, ale program może później zgłosić brak dodatkowego pliku. W razie problemów przejdź najpierw do katalogu aplikacji poleceniem cd.

Niektóre programy przyjmują argumenty. Umieszcza się je po nazwie pliku:

java -jar aplikacja.jar --config config.yml --port 8080

Znaczenie argumentów zależy od konkretnego programu. Nie dopisuj ich na ślepo. Sprawdź dokumentację lub uruchom:

java -jar aplikacja.jar --help

W przypadku większych aplikacji, na przykład serwera gry, przydają się parametry pamięci JVM:

java -Xms1G -Xmx4G -jar serwer.jar

-Xms1G określa początkowy rozmiar pamięci, a -Xmx4G jej maksymalny limit. Nie oznacza to, że program zawsze wykorzysta całą tę pamięć. Ustawienie zbyt wysokiego limitu może jednak pogorszyć działanie systemu, szczególnie na VPS-ie z małą ilością RAM. Wartość powinna wynikać z wymagań aplikacji i zasobów maszyny.

Gdy program działa w terminalu pierwszoplanowo, jego komunikaty widzisz na bieżąco. Zwykle zakończysz go skrótem Ctrl+C. Jeśli aplikacja ma własną komendę zamykania, użyj jej zamiast przerywania procesu. Nagłe przerwanie może uniemożliwić zapis konfiguracji lub uszkodzić dane, choć zależy to od sposobu działania programu.

W drugim terminalu możesz sprawdzić, czy proces Java działa:

pgrep -af java

Alternatywnie użyj:

ps aux | grep '[j]ava'

Pierwsza metoda jest krótsza. Druga pokazuje więcej informacji, ale filtr z nawiasami ogranicza pojawianie się samego polecenia grep na liście wyników.

Uruchomienie pliku JAR przez interfejs graficzny

W środowisku graficznym można spróbować dwukrotnie kliknąć plik JAR w menedżerze plików. Rezultat zależy jednak od dystrybucji, menedżera plików i bieżącego skojarzenia typu MIME. System może otworzyć archiwum w programie do obsługi plików ZIP, wyświetlić pytanie o uruchomienie albo nie zrobić nic.

Nie jest to dowód, że plik jest uszkodzony. Dwuklik często nie działa z kilku powodów: Java nie jest zainstalowana, plik nie ma przypisanej aplikacji, menedżer plików blokuje wykonywanie, a program wymaga terminala lub dodatkowych argumentów.

Najpierw warto ustalić działającą komendę w terminalu. Dopiero potem konfiguruj wygodny skrót. W ustawieniach właściwości pliku możesz znaleźć opcję typu „Otwieraj za pomocą” i wskazać Javę, ale nazwa programu może się różnić. Samo przypisanie pliku do interpretera nie rozwiązuje problemu, jeśli JAR nie ma wpisu Main-Class albo wymaga parametrów.

Możesz sprawdzić bieżące skojarzenie MIME poleceniem:

xdg-mime query filetype aplikacja.jar

Typowym wynikiem jest application/java-archive. Skojarzenia można zmienić za pomocą xdg-mime, ale potrzebujesz nazwy pliku desktop zainstalowanej aplikacji. Ponieważ różne dystrybucje mogą używać innych nazw, tworzenie własnego skrótu jest często bardziej przewidywalne.

Tworzenie skrótu .desktop dla pliku JAR

Pliki .desktop opisują aplikacje widoczne w menu środowiska graficznego. Utwórz katalog na własne skróty, jeśli jeszcze go nie ma:

mkdir -p ~/.local/share/applications

Następnie utwórz plik:

nano ~/.local/share/applications/moja-aplikacja.desktop

Wklej do niego prostą konfigurację:

[Desktop Entry]
Name=Moja aplikacja Java
Comment=Uruchamia aplikację JAR
Exec=java -jar /home/uzytkownik/Aplikacje/aplikacja.jar
Icon=java
Terminal=true
Type=Application
Categories=Utility;

Zapisz plik i zamknij edytor. Wartość Exec musi wskazywać prawidłową ścieżkę. Najbezpieczniej przechowywać aplikację w katalogu bez spacji, na przykład /home/uzytkownik/Aplikacje/. Jeśli program ma otwierać okno graficzne i nie chcesz widzieć terminala, ustaw Terminal=false. Na etapie testów lepiej pozostawić true, bo komunikat błędu nie zniknie natychmiast.

Pole Icon może zawierać nazwę ikony dostępnej w systemie albo pełną ścieżkę do pliku graficznego, na przykład:

Icon=/home/uzytkownik/Aplikacje/ikona.png

Po zapisaniu skrót powinien pojawić się w menu aplikacji. W niektórych środowiskach trzeba wylogować się, odświeżyć menu albo kliknąć plik prawym przyciskiem i potwierdzić jego zaufanie. Nie ustawiaj skrótu jako wykonywalnego w nadziei, że to zastąpi komendę Java. Dla pliku desktop uprawnienie wykonywania może być potrzebne zależnie od środowiska, ale sam JAR nadal uruchamia interpreter Java.

Jeśli aplikacja wymaga konkretnego katalogu roboczego, prosty wpis Exec=java -jar ... może nie wystarczyć. Wtedy można użyć powłoki:

Exec=sh -c 'cd /home/uzytkownik/Aplikacje && exec java -jar aplikacja.jar'

Składnia plików desktop ma własne zasady uciekania znaków, dlatego przed zastosowaniem takiego wariantu sprawdź komendę osobno w terminalu. Dla początkującego prostszy i bardziej odwracalny jest skrót wskazujący pełną ścieżkę oraz uruchamianie z terminalem włączonym.

Najczęstsze błędy i sposoby ich naprawy

Gdy plik JAR nie uruchamia się w Linuxie, nie zaczynaj od losowego instalowania kolejnych pakietów. Najpierw odczytaj cały komunikat z terminala. Zwykle wskazuje on kategorię problemu.

Komunikat Prawdopodobna przyczyna Co sprawdzić
command not found: java Brak Javy lub nieprawidłowy PATH. Zainstaluj OpenJDK i ponów java -version.
Unable to access jarfile Błędna nazwa, ścieżka albo brak odczytu. Użyj pwd, ls i sprawdź wielkość liter.
no main manifest attribute Manifest nie wskazuje klasy głównej. Sprawdź dokumentację albo klasę startową; JAR może nie być samodzielną aplikacją.
UnsupportedClassVersionError Aplikacja wymaga nowszej Javy niż zainstalowana. Zainstaluj zgodną wersję lub użyj starszej wersji wymaganej przez program.
Permission denied Brak odczytu JAR-a albo dostępu do katalogu. Sprawdź ls -l i prawa do katalogów nadrzędnych.

Komunikat no main manifest attribute nie oznacza automatycznie uszkodzenia pliku. Taki JAR może być biblioteką albo paczką zbudowaną bez wskazania punktu startowego. Jeśli znasz nazwę klasy głównej, możesz spróbować uruchomić ją bez opcji -jar:

java -cp aplikacja.jar pakiet.Main

To rozwiązanie wymaga znajomości struktury programu i ewentualnych zależności. W przypadku gotowej aplikacji lepiej pobrać właściwy pakiet albo sprawdzić instrukcję producenta niż zgadywać nazwę klasy.

UnsupportedClassVersionError oznacza najczęściej, że program został skompilowany nowszą Javą niż ta używana przy uruchamianiu. Instalacja najnowszego dostępnego OpenJDK może pomóc, ale czasem aplikacja wymaga konkretnej starszej wersji. Nie zmieniaj środowiska na serwerze produkcyjnym bez sprawdzenia, czy inne programy również z niego korzystają.

Jeśli terminal zgłasza brak pliku, sprawdź bieżący katalog:

pwd
ls -lah

Linux rozróżnia wielkość liter, więc Aplikacja.jar i aplikacja.jar to różne nazwy. Przy błędzie uprawnień skontroluj dostęp:

ls -l aplikacja.jar
namei -l /ścieżka/do/aplikacja.jar

Użytkownik musi mieć prawo odczytu pliku oraz prawo przejścia przez każdy katalog na ścieżce. Zmiana właściciela lub szerokie użycie chmod 777 nie jest dobrym pierwszym krokiem. Takie działania mogą pogorszyć bezpieczeństwo. Najpierw przenieś plik do katalogu, do którego masz dostęp, albo skonsultuj uprawnienia z administratorem.

Jeśli aplikacja uruchamia się po dwukliku i natychmiast znika, ustaw Terminal=true w skrócie albo uruchom ją ręcznie. Wtedy zobaczysz błąd, którego środowisko graficzne nie pokazuje. Częstą przyczyną jest brak pliku konfiguracyjnego, niezgodna Java, wymagany argument lub program przeznaczony wyłącznie do pracy w terminalu.

Uruchamianie pliku JAR w tle i na serwerze

Na serwerze VPS zamknięcie sesji SSH może zakończyć proces uruchomiony w zwykłym terminalu. Do prostych zastosowań możesz użyć nohup:

nohup java -Xms1G -Xmx2G -jar aplikacja.jar > aplikacja.log 2>&1 &

W tym poleceniu:

  • nohup pozwala procesowi działać po rozłączeniu sesji,
  • > aplikacja.log zapisuje standardowe wyjście do pliku,
  • 2>&1 kieruje również komunikaty błędów do tego samego pliku,
  • znak & uruchamia proces w tle.

Log możesz obserwować na bieżąco:

tail -f aplikacja.log

Proces zatrzymasz po znalezieniu jego identyfikatora:

pgrep -af aplikacja.jar
kill PID

Zastąp PID numerem procesu. kill -9 traktuj jako ostateczność, gdy program nie reaguje na zwykłe zakończenie. Nagłe przerwanie może spowodować utratę danych, szczególnie w aplikacjach zapisujących stan na dysku.

Wygodniejszym rozwiązaniem podczas pracy administracyjnej jest screen. Zainstaluj go, jeśli nie ma go w systemie:

sudo apt install screen

Utwórz sesję o nazwie:

screen -S aplikacja

W jej obrębie uruchom program:

java -Xms1G -Xmx2G -jar aplikacja.jar

Aby odłączyć sesję bez zatrzymywania aplikacji, naciśnij Ctrl+A, a następnie D. Po ponownym połączeniu z serwerem wrócisz do niej poleceniem:

screen -r aplikacja

Listę aktywnych sesji sprawdzisz tak:

screen -ls

screen jest praktyczny, gdy aplikacja ma konsolę interaktywną i chcesz obserwować jej komunikaty. nohup lepiej pasuje do prostego procesu, którego nie trzeba ręcznie obsługiwać. Żadne z tych narzędzi nie zastępuje usługi systemowej, monitorowania ani kopii zapasowych. Jeśli aplikacja ma działać stale i restartować się po awarii, w dalszej perspektywie warto skonfigurować ją jako usługę systemd, ale wymaga to ostrożnego dopasowania użytkownika, katalogu i uprawnień.

Parametr --nogui stosuj tylko wtedy, gdy obsługuje go dana aplikacja. Jest popularny w przypadku niektórych serwerów gier, ale nie jest uniwersalną opcją Javy:

java -Xms2G -Xmx4G -jar serwer.jar --nogui

Jeżeli program jej nie rozpoznaje, usuń ją i sprawdź instrukcję. Na serwerze bez środowiska graficznego nie instaluj pełnego pulpitu tylko dlatego, że aplikacja ma opcję „GUI”. Wiele serwerów działa poprawnie w trybie headless, ale programy desktopowe z oknami mogą wymagać dodatkowych komponentów.

Szybka ściąga i najważniejsze komendy

Najprostszy schemat uruchamiania wygląda następująco:

  1. Sprawdź środowisko poleceniem java -version i zainstaluj odpowiednią wersję OpenJDK.
  2. Przejdź do katalogu z plikiem przez cd albo skopiuj jego pełną ścieżkę.
  3. Uruchom aplikację poleceniem java -jar nazwa.jar.
  4. Odczytaj komunikat w terminalu, jeśli program nie wystartuje; nie próbuj diagnozować problemu przez sam dwuklik.
  5. Po udanym teście utwórz skrót .desktop albo użyj screen czy nohup na serwerze.

Przydatne polecenia w jednym miejscu:

java -version
which java
pwd
ls -lah
cd /ścieżka/do/katalogu
java -jar aplikacja.jar
java -jar aplikacja.jar --help
pgrep -af java
tail -f aplikacja.log

Jeżeli nadal nie ma wyniku, sprawdź wymagania aplikacji, wersję Java, nazwę pliku oraz to, czy pobrany JAR jest rzeczywiście programem uruchamialnym, a nie biblioteką. Pomocny bywa także komunikat błędu wyszukany dokładnie, razem z nazwą aplikacji i numerem wersji. Nie publikuj przy tym haseł, tokenów ani prywatnych danych zapisanych w logach.

Najważniejsza zasada jest prosta: najpierw sprawdź Javę i uruchom plik w terminalu, a dopiero później konfiguruj wygodny dwuklik. Komenda java -jar pozwala odróżnić problem środowiska od problemu samego JAR-a. Po prawidłowym teście możesz bezpiecznie dodać skrót graficzny lub przenieść proces do sesji działającej w tle. Dzięki temu wiesz nie tylko, jak uruchomić plik JAR w Linuxie, ale też gdzie szukać przyczyny, gdy aplikacja przestanie działać.

Czy Artykuł był pomocny?

Kliknij w gwiazdkę żeby ocenić!

Ocena 0 / 5. Wynik: 0

Brak ocen, bądź pierwszy!

Udostępnij:

Komentarze

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *

getce.pl
Przegląd prywatności

Ta strona korzysta z ciasteczek, aby zapewnić Ci najlepszą możliwą obsługę. Informacje o ciasteczkach są przechowywane w przeglądarce i wykonują funkcje takie jak rozpoznawanie Cię po powrocie na naszą stronę internetową i pomaganie naszemu zespołowi w zrozumieniu, które sekcje witryny są dla Ciebie najbardziej interesujące i przydatne.