Merge pull request #62 from RetGal/upnp

Add Upnp
RetGal · Apr 16, 2023 · c505ead · c505ead
2 parents 4d2ddee + 5907906
commit c505ead
Show file tree

Hide file tree

Showing 29 changed files with 223 additions and 59 deletions.
diff --git a/build.xml b/build.xml
@@ -58,7 +58,7 @@
 
 	<target name="build" depends="compile" description="Build the jar">
 		<jar destfile="${dir.build}/dayon.jar">
-			<zipgroupfileset dir="${dir.binfile}/lib" includes="xz-1.9.jar"/>
+			<zipgroupfileset dir="${dir.binfile}/lib" includes="xz-1.9.jar,WaifUPnP.jar"/>
 			<manifest>
 				<attribute name="Application-Name" value="Dayon!"/>
 				<attribute name="Implementation-Version" value="${version}"/>

diff --git a/docs/assistant_network_settings.jpg b/docs/assistant_network_settings.jpg
diff --git a/docs/assistant_network_settings_noupnp.jpg b/docs/assistant_network_settings_noupnp.jpg
diff --git a/docs/assistant_network_settings_upnp.jpg b/docs/assistant_network_settings_upnp.jpg
diff --git a/docs/de_download.html b/docs/de_download.html
@@ -107,6 +107,13 @@ <h2>Download</h2>
         </p>
 
         <h2>Changelog</h2>
+        <h3>Dayon! v12 Adorable Asteroid (16. April 2023)</h3>
+        <ul>
+          <li>Automatische Portweiterleitung</li>
+          <li>Quick Launch Versionen für Linux</li>
+          <li>Modernisiertes GUI</li>
+        </ul>
+
         <h3>Dayon! v11 Ballsy Beaver (31. Oktober 2021)</h3>
         <ul>
           <li>Verbindung mittels Token</li>

diff --git a/docs/de_index.html b/docs/de_index.html
@@ -72,7 +72,7 @@ <h3>
           </p>
         </div>
 
-        <h2>Status (11)</h2>
+        <h2>Status (12)</h2>
         <p>
           Seit Release 1.9 (Promiscuous Potato) existiert nebst den
           konventionellen Installationspaketen eine portable "quick launch"
@@ -82,6 +82,7 @@ <h2>Status (11)</h2>
           weil man damit den Assistenten oder den Assistierten unter Windows
           ohne vorgängige Installation direkt starten kann. Sie sind 100%ig
           kompatibel zu den konventionellen Dayon! Versionen.
+          Seit Release 12 (Adorable Asteroid) existieren ähnliche portable Versionen auch für Linux.
           <br/><br/>
           Mangels entsprechender Hardware konnte ich die Funktion zur
           Übertragung der Zwischenablage bloss mit Windows 10 und 11, Debian und Ubuntu

diff --git a/docs/de_quickstart.html b/docs/de_quickstart.html
@@ -108,19 +108,20 @@ <h2>Schnellstart</h2>
 
         <p>
           Standardmässig horcht der Server auf <strong>Port</strong> 8080, sie können diesen aber bei Bedarf ändern.
-          Dieser Port auf der <strong>Firewall</strong> für eingehenden Verkehr geöffnet. In den meisten Fällen wird es
-          notwendig sein, den Port via <strong>NAT</strong> auf dem <strong>Router</strong> an den entsprechenden Rechner weiterzuleiten.
+          Seit Version 12, richtet Dayon! eine entsprechende Portweiterleitung selbständig ein. Voraussetzung dafür ist aber, dass <strong>UPnP</strong> aktiviert ist.
+          Ansonsten wird es weiterhin notwendig sein, den Port (TCP) via <strong>NAT</strong> auf dem <strong>Router</strong> an den entsprechenden Rechner weiterzuleiten.
           <br/><br/>
           Bebilderte Schritt-für-Schritt-Anleitungen für das Einrichten von Portweiterleitungen für die gängigsten Router Modelle finden sie
           beispielsweise auf <a href="https://portforward.com/router.htm">portforward.com</a>.
         </p>
 
         <p>
-          <strong>Optional:</strong> Port für eingehende Verbindungen anpassen:
+          <strong>Optional:</strong> Port für eingehende Verbindungen anpassen: (links mit aktiviertem UPnP, rechts ohne)
         </p>
 
         <p>
-          <img src="assistant_network_settings.jpg" alt="Dayon! Assistent: Network Settings"/>
+          <img src="assistant_network_settings_upnp.jpg" alt="Dayon! Assistent: Network Settings mit UPnP"/>
+          <img src="assistant_network_settings_noupnp.jpg" alt="Dayon! Assistent: Network Settings ohne UPnP"/>
         </p>
 
         <p>

diff --git a/docs/download.html b/docs/download.html
@@ -105,6 +105,13 @@ <h2>Download</h2>
         </p>
 
         <h2>Change log</h2>
+        <h3>Dayon! v12 Adorable Asteroid (April 16th, 2023)</h3>
+        <ul>
+          <li>Automatic port forwarding</li>
+          <li>Quick launch versions for Linux</li>
+          <li>Modernized GUI</li>
+        </ul>
+
         <h3>Dayon! v11 Ballsy Beaver (October 31th, 2021)</h3>
         <ul>
           <li>Connection via access token</li>

diff --git a/docs/fr_download.html b/docs/fr_download.html
@@ -105,6 +105,13 @@ <h2>Télécharger</h2>
         </p>
 
         <h2>Journal des modifications</h2>
+        <h3>Dayon! v12 Adorable Asteroid (16 avril 2023)</h3>
+        <ul>
+          <li>Transfert de port automatique</li>
+          <li>Versions «lancement rapide» pour Linux</li>
+          <li>Interface graphique moderniseé</li>
+        </ul>
+
         <h3>Dayon! v11 Ballsy Beaver (31 octobre 2021)</h3>
         <ul>
           <li>Connexion à l'aide du code d'accès</li>
@@ -122,7 +129,7 @@ <h3>
         </ul>
 
         <h3>
-          Dayon! v1.9 Promiscuous Potato (11 decembre 2019)
+          Dayon! v1.9 Promiscuous Potato (11 décembre 2019)
           <span class="red">*</span>
         </h3>
         <ul>
@@ -153,7 +160,7 @@ <h3>
         </ul>
 
         <h3>
-          Dayon! v1.6 Solenodon (19 decembre 2018)
+          Dayon! v1.6 Solenodon (19 décembre 2018)
           <span class="red">*</span>
         </h3>
         <ul>
@@ -218,7 +225,7 @@ <h3>
         </ul>
 
         <h3>
-          Dayon! v1.1 (24 decembre 2008)
+          Dayon! v1.1 (24 décembre 2008)
           <span class="red">*</span>
         </h3>
         <ul>
@@ -230,7 +237,7 @@ <h3>
           <li>L'interface graphique est un peu plus polie</li>
         </ul>
 
-        <h3>Dayon! v1.0 (4 decembre 2008)</h3>
+        <h3>Dayon! v1.0 (4 décembre 2008)</h3>
         <ul>
           <li>Première version</li>
         </ul>

diff --git a/docs/fr_index.html b/docs/fr_index.html
@@ -72,7 +72,7 @@ <h3>
           </p>
         </div>
 
-        <h2>Status (11)</h2>
+        <h2>Status (12)</h2>
         <p>
           Depuis la version 1.9 (Promiscuous Potato), une version portable
           "lancement rapide" est disponible en plus de la programme
@@ -81,6 +81,8 @@ <h2>Status (11)</h2>
           appelés "lancement rapide", car ils permettent de lancer la partie
           assistée ou assistante sans installation. Ils sont 100% compatibles
           avec les versions classiques de Dayon!.
+          Depuis la version 12 (Adorable Asteroid), des versions portables similaires
+          sont également disponibles pour Linux.
           <br/><br/>
           En raison du manque de matériel, je n'ai pu tester la fonction de
           transfert du presse-papiers que sous Windows 10 et 11, Debian et Ubuntu. Les

diff --git a/docs/fr_quickstart.html b/docs/fr_quickstart.html
@@ -96,20 +96,22 @@ <h2>Premier Pas</h2>
         </p>
 
         <p>
-          Dayon! Assistant se comporte comme une application serveur (vers laquelle l'<em>assistée</em>
-          va se connecter). Vous devez donc configurer le réseau pour rendre votre application visible depuis l'extérieur.
-          Par défaut, le serveur écoute le <strong>Port</strong> 8080, mais vous pouvez le modifier si nécessaire. Ensuite, il faudra
-          autoriser ce port dans votre <strong>parefeu</strong> et sans doute configurer un service <strong>NAT</strong> sur votre routeur DSL.
+          Dayon! Assistant agit comme une application serveur typique (l'<em>assisté</em> va se connecter) et en tant que tel, vous devez configurer votre réseau
+          pour le rendre visible du monde extérieur.<br/><br/>
+          Par défaut, le serveur écoute le <strong>port</strong> 8080, mais vous pouvez le modifier si nécessaire.
+          Depuis la version 12, Dayon! crée indépendamment une règle de transfert de port correspondante. La condition préalable est que <strong>UPnP</strong> soit activé.
+          Sinon, il sera toujours nécessaire de rediriger le port (TCP) via <strong>NAT</strong> sur le <strong>routeur</strong> vers l'ordinateur correspondant.
           <br/><br/>
-          Consultez <a href="https://portforward.com/router.htm">portforward.com</a> pour un guide étape par étape pour les plus courants modèles de routeurs.
+          Consultez <a href="https://portforward.com/router.htm">portforward.com</a> pour un guide étape par étape des modèles de routeur les plus courants.
         </p>
 
         <p>
-          <strong>Optional:</strong> Ajuster le port pour les connexions entrantes:
+          <strong>Optional:</strong> Ajuster le port pour les connexions entrantes: (à gauche avec UPnP, à droite sans)
         </p>
 
         <p>
-          <img src="assistant_network_settings.jpg" alt="Dayon! Assistant: Network Settings"/>
+          <img src="assistant_network_settings.jpg" alt="Dayon! Assistant: Network Settings avec UPnP"/>
+          <img src="assistant_network_settings.jpg" alt="Dayon! Assistant: Network Settings sans UPnp"/>
         </p>
 
         <p>

diff --git a/docs/index.html b/docs/index.html
@@ -68,15 +68,16 @@ <h3>
           </p>
         </div>
 
-        <h2>Status (11)</h2>
+        <h2>Status (12)</h2>
         <p>
           Since release 1.9 (Promiscuous Potato), a portable "quick launch"
           version is available in addition to the conventional installation
           program. There are two separate "quick launch" Windows binaries, one
           for the assisted and one the assistant. They are called "quick
           launch", because they allow the assisted or assistant part to be run
           without prior installation. They are 100% compatible with the
-          conventional Dayon! Versions.
+          conventional Dayon! Versions. Since release 12 (Adorable Asteroid),
+          similar portable versions are available for Linux as well.
           <br/><br/>
           Due to the lack of Apple hardware, the clipboard transfer feature
           could only be tested with Windows 10 and 11, Debian and Ubuntu - Feedback

diff --git a/docs/quickstart.html b/docs/quickstart.html
@@ -100,22 +100,22 @@ <h2>Quick Start</h2>
         </p>
 
         <p>
-            Dayon! Assistant is acting as a typical server application (the
-            <em>assisted</em> is going to connect to) and as such you've to configure your network
-            to make it visible from the outside world. By default, the server listens to <strong>Port</strong>
-            8080, but you can change this if necessary. Authorize that port number in your <strong>firewall</strong>
-            and possibly setup accordingly your <strong>NAT</strong> services (typically on your router).
+            Dayon! Assistant is acting as a typical server application (the <em>assisted</em> is going to connect to) and as such you've to configure your network
+            to make it visible from the outside world.<br/><br/>
+            By default, the server listens to <strong>Port</strong> 8080, but you can change this if necessary.
+            Since version 12, Dayon! creates a corresponding port forwarding rule independently. The prerequisite for this is that <strong>UPnP</strong> is activated.
+            Otherwise, it will still be necessary to forward the port (TCP) via <strong>NAT</strong> on the <strong>router</strong> to the corresponding computer.
             <br/><br/>
-            Check out <a href="https://portforward.com/router.htm">portforward.com</a> for a step-by-step guide for
-            the most common router models.
+            Check out <a href="https://portforward.com/router.htm">portforward.com</a> for a step-by-step guide for the most common router models.
         </p>
 
         <p>
-            <strong>Optional:</strong> Adjust port for incoming connections:
+            <strong>Optional:</strong> Adjust port for incoming connections: (on the left with UPnP, on the right without)
         </p>
 
         <p>
-            <img src="assistant_network_settings.jpg" alt="Dayon! Assistant: Network Settings"/>
+            <img src="assistant_network_settings_upnp.jpg" alt="Dayon! Assistant: Network Settings with UPnP"/>
+            <img src="assistant_network_settings_noupnp.jpg" alt="Dayon! Assistant: Network Settings without UPnP"/>
         </p>
 
         <p>

diff --git a/docs/zh_download.html b/docs/zh_download.html
@@ -111,6 +111,13 @@ <h2>下载</h2>
         </p>
 
         <h2>更新日志</h2>
+        <h3>Dayon! v12 Adorable Asteroid（2023年4月16日）</h3>
+        <ul>
+          <li>自动端口转发</li>
+          <li>Linux 的快速启动版本</li>
+          <li>现代化的 GUI</li>
+        </ul>
+
         <h3>Dayon! v11 Ballsy Beaver 更新内容(2021年10月31日)</h3>
         <ul>
           <li>通过访问代码连接</li>

diff --git a/docs/zh_index.html b/docs/zh_index.html
@@ -39,10 +39,11 @@ <h3>
             </h3>
             <p>Dayon! 通过压缩算法和发送缓存的黑白(最高 256 色)图像以最大限度地减少网络资源使用，尽可能多地提供实时体验。Dayon!所提供的黑白屏幕影像质量足以清除分辨菜单、图标和查看计算机设置等... 
         </div>
-        <h2>公告 (11)</h2>
+        <h2>公告 (12)</h2>
         <p>从 1.9 (Promiscuous Potato) 版本开始，同主程序一起发布的还有绿色(Portable)、便携的 "快速启动(Quick Launch)"版本
             目前发布有两个“快速启动”的Windows 二进制可执行文件(exe)：一个是控制端(主控端 - Assistant)，另一个是被控端(用户端 - Assisted)。
-            之所以称为“快速启动”版本，是由于它们无需安装便可运行。“快速启动”版本与同版本号的常规发布版本(需要安装的) 100% 兼容。<br><br>
+            之所以称为“快速启动”版本，是由于它们无需安装便可运行。“快速启动”版本与同版本号的常规发布版本(需要安装的) 100% 兼容。
+            从第 12 版（Adorable Asteroid）开始，类似的可移植版本也可用于 Linux。<br><br>
             由于缺少苹果硬件，剪贴板传输功能只能在 Windows 10 和 11、Debian 和 Ubuntu 上做了测试 - 非常欢迎 macOS 用户的反馈！
         <h2>讲个小故事…</h2>
         <p> Marc Polizzi 开发了Dayon! 。他当时住在菲律宾，通过Skype与远在欧洲的家人和朋友联络。

diff --git a/docs/zh_quickstart.html b/docs/zh_quickstart.html
@@ -63,17 +63,20 @@ <h2>快速入门</h2>
             <strong>配置主控端(Assistant)——如何开始远程协助</strong></a>
         <p>
             Dayon! Assistant 充当典型的服务器应用程序（<em>Assisted</em> 将连接到），因此您必须配置您的网络以使其从外部世界可见 .
+        <p>
             默认情况下，服务器侦听<strong>端口</strong> 8080，但您可以根据需要更改此设置。
-            在您的<strong>防火墙</strong>中授权该端口号，并可能相应地设置您的<strong>NAT</strong>服务（通常在您的 DSL 路由器上）。 <br><br>
+            从第12版开始，Dayon！ 独立对应的端口转发。 这样做的先决条件是 <strong>UPnP</strong> 已激活。
+            否则仍然需要通过<strong>路由器</strong>上的<strong>NAT</strong>将端口（TCP）转发到相应的计算机。<br/><br/>
             译者注：上面说了那么多，说白就是你要让你的计算机暴露在公网，让用户可以访问得到你。如果你有公网IP，这自然是最方便
             的。如果你和我一样，没有公网IP，那可以使用内网穿透、VPN等。比如FRP、Ngrok、OpenVPN、ZeroTier等，有些是需要自己有服
             务器才能搭建，而有些则不需要，而且网上有很多热心网友贡献的免费通道，请自行百度，谢谢。
             <br><br>
             在 <a href="https://portforward.com/router.htm">portforward.com</a> 可以查询到常见的路由器(端口转发相关内容)的详细配置指南。
         <p>
-            <strong>可选：</strong>调整传入连接的端口：
+            <strong>可选：</strong>调整传入连接的端口：（左边有 UPnP，右边没有）
         <p>
-            <img src="assistant_network_settings.jpg" alt="Dayon! Assistant: Network Settings">
+            <img src="assistant_network_settings_upnp.jpg" alt="Dayon! Assistant: Network Settings with UPnP"/>
+            <img src="assistant_network_settings_noupnp.jpg" alt="Dayon! Assistant: Network Settings without UPnP"/>
         <p>
             通过单击密钥生成访问令牌：
         <p>

diff --git a/lib/WaifUPnP.jar b/lib/WaifUPnP.jar
diff --git a/pom.xml b/pom.xml
@@ -17,7 +17,7 @@
             <email>[email protected]</email>
         </developer>
     </developers>
-    <inceptionYear>2016-2022</inceptionYear>
+    <inceptionYear>2016-2023</inceptionYear>
     <licenses>
         <license>
             <name>GPL-3</name>
@@ -38,6 +38,13 @@
     </properties>
 
     <dependencies>
+        <dependency>
+            <groupId>com.dosse.upnp</groupId>
+            <artifactId>WaifUPnP</artifactId>
+            <version>1.3.0</version>
+            <scope>system</scope>
+            <systemPath>${project.basedir}/lib/WaifUPnP.jar</systemPath>
+        </dependency>
         <dependency>
             <groupId>org.tukaani</groupId>
             <artifactId>xz</artifactId>