使用 j-lunker 来在线演示你的前端代码

每天读一篇一线开发者原创好文

J-lunker

English Version

链接：https://github.com/rdkmaster/j-lunker/blob/master/README.md

用J-lunker来做啥

J-lunker可以在线运行任意前端代码，并且可以在代码被编辑之后，J-lunker会立即重新运行他们。它可以让你很方便的将代码及其结果和行为分享给他人。

为啥需要J-lunker

避免被GFW干扰：这是我创造J-lunker的最主要原因，GFW在我们使用plunker来分享和运行代码的过程中，制造了太多的麻烦了，Jigsaw的demo代码的读者们常常抱怨这一点。

更快的速度：我在国内部署了一个J-lunker的服务器，这样就可以让多数Jigsaw的demo代码读者享受到更快的代码打开和运行速度了，相信他们会很开心的。

只将代码及其运行效果共享给授信的人，而非所有人：J-lunker极其轻量，因此它可以非常容易的部署到任何范围可控且安全的环境中去，因此你就不需要担心你将代码发给plunker上去运行之后，被不信任的人（包括plunker在内）偷走了。

如果上述任何一个理由也适合你，那么J-lunker就是一个更好的选择。

代码持久化在哪

J-lunker本身不永久保存被运行的代码，代码由J-lunker的用户自行保存，J-lunker只是提供在线运行他们的功能。如果你和Jigsaw、angular.io、angular.cn那样，也有大量需要在线演示的代码的话，那J-lunker对你来说是很适合的工具。自行持久化代码的好处是你可以很容易通过CI或者其他脚本来更新或者生成这些代码。

如何使用

action="http://rdk.zte.com.cn/rdk/service/app/j-lunker/server/eval">

h1 {

font-size: 30px;

transition: .5s;

}

h1:hover {

color: red;

}

a {

cursor: pointer;

transition: .3s;

}

a:hover {

color: blue;

}

"/>

function gotoProject() {

window.open('https://github.com/rdkmaster/j-lunker');

}

">

J-lunker basic template

这个embed.html文件没有任何依赖，可以将它保存到你的web服务器下的任意目录，这样你就可以通过对应的链接来将他分享给任何人了，或者也可以将代码插入在你的文档、文章中去。使用CI或者脚本来创建这样的文件是很简单的事情。

注意到这个文件的核心部分是一个表单（form），以及一些隐藏了的inputs。这些inputs的name属性值定义了一个J-lunker可识别的属性，value定义了该属性的值。J-lunker目前可以支持的属性有：

option[show]：关键字option表明这里定义的是一个选项，show是这个选项的名字，它的值是index.html,preview，这个选项告诉J-lunker在页面准备继续之后，就打开index.html这个文件，以及打开运行效果预览区。

entries[asset/styles.css][content]：entries用于定义一个文件，asset/styles.css是文件名和路径。此属性的值就是文件的内容。注意需要对文件内容做uri编码。

title：此属性用于定义运行结果的页面的标题。

如何部署

如果你只需要运行你的代码，你是无需部署J-lunker服务器的，请先阅读这个小节，然后再决定是否继续按照这个小节的说明部署你自己的J-lunker服务器。

这个小节说明了如何部署一台独立的J-lunker服务器，由此，你就可以使用你自己部署的J-lunker服务器来运行你的代码了，被运行的代码不需要发送到公网上，因此被运行的代码的安全性就可以得到保障。

详细步骤如下：

克隆或者下载这个仓库的代码，并且解压缩到一个任意目录，最好不要解压到有空格或者中文的目录中。

J-lunker的服务端需要jre1.8以上，如果你的运行环境上没有，则请安装或者设置JAVA_HOME指向jre1.8。如果你的环境无法安装或者不方便设置环境变量，你也可以将jre1.8拷贝到proc/bin/jre目录下。

如果你想将J-lunker部署在Windows上，或者只想试一试，那么双击start.bat就可以启动J-lunker的服务端和web服务器了。接下来你可以按照这个小节的方法来测试你自己的J-lunker服务器了。别忘了将例子中的http://rdk.zte.com.cn改为http://localhost:8080。

如果你想将J-lunker部署在其他操作系统上，则还要继续：

配置你的web服务器，这里用nginx作为例子。首先你需要在nginx.conf中的server节点下添加一个反向代理配置：

location/rdk/service{

proxy_pass http://localhost:5812;

}

这个配置项告诉nginx将所有包含/rdk/service关键字的URL转发给J-lunker的服务器，别忘了需要重启一下nginx。

你可以对比这个文件，它也许可以帮助你解决这方面的配置问题。

将www目录设置为你的web服务器的根目录，如果你的web服务器已经有一个根了，则可以将下面这几行插入到nginx.conf中的server节点下

location/j-lunker{

root/dir/to/j-lunker/www/;

index index.html index.htm;

}

你可以对比这个文件，它也许可以帮助你解决这方面的配置问题。

将web服务器的监听端口改为任何你喜欢的，默认是8080。

到proc/bin目录下，执行sh run.sh命令，它将启动J-lunker的服务端，再次提醒，J-lunker的服务端需要jre1.8以上。

如果你碰到了任何困难，欢迎给我提issue。

共创共建

我非常欢迎你给我推送PR。

J-lunker的默认首页现在非常简陋，而且我不会有太多的时间花在它上面，我很希望有人能够帮我完善它，具体请参考这个issue: