注意事项 PyWebIO静态资源的托管 PyWebIO默认使用CDN来获取前端的静态资源，如果要将PyWebIO应用部署到 离线环境中，需要自行托管静态文件， 并将 webio_view() 或 webio_handler() 的 cdn 参数设置为 False ，此时需要将静态资源托管在和PyWebIO应用同级的 目录下。 同时，也可以通过 cdn 参数直接设置PyWebIO静态资源的部署目录。 PyWebIO的静态文件的路径可保存在 PyWebIO的静态文件的路径可保存在 pywebio.STATIC_PATH 中，可使用命令 python3 -c "import pywebio; print(pywebio.STATIC_PATH)" 将其打印出来。 注解 使用 start_server() 启动的应用，如果将 cdn 参数设置为 False ，会自动启 动一个本地的静态资源托管服务，无需手动托管。 基于协程的会话 [https://www.tornadoweb.org/en/stable/guide/running.html#debug-mode] cdn (bool/str) – 是否从CDN加载前端静态资源，默认为 True 。支持传入自定义的URL来指定静态资源的部署地 址 allowed_origins (list) – 除当前域名外，服务器还允许的请求的来源列表。 来源 包含协议、域名和端口部分，允许使用 Unix shell

PyWebIO 静态资源的托管 PyWebIO 默认使用 CDN 来获取前端的静态资源，如果要将 PyWebIO 应用部署到离线环境中，需要自行托管 静态文件，并将 webio_view() 或 webio_handler() 的 cdn 参数设置为 False ，此时需要将静态资源 托管在和 PyWebIO 应用同级的目录下。同时，也可以通过 cdn 参数直接设置 PyWebIO 静态资源的部署目录。 静态资源的部署目录。 PyWebIO 的静态文件的路径可保存在 pywebio.STATIC_PATH 中，可使用命令 python3 -c "import pywebio; print(pywebio.STATIC_PATH)" 将其打印出来。 注解: 使用 start_server() 启动的应用，如果将 cdn 参数设置为 False ，会自动启动一个本地的静态 资源托管服务，无需手动托管。 4 Server 的 debug 模式，开启后，代码发生修改后服 务器会自动重启。详情请参阅 tornado 文档 • cdn (bool/str) –是否从 CDN 加载前端静态资源，默认为 True 。支持传入自定义 的 URL 来指定静态资源的部署地址 • allowed_origins (list) –除当前域名外，服务器还允许的请求的来源列表。来 源包含协议、域名和端口部分，允许使用 Unix

IO前端静态文件；暴露 PyWebIO后端接口。这其中需要注意前端页面和后端接口的路径约定， 以及前 端静态文件与后端接口分开部署时因为跨域而需要的特别设置。 集成方法 不同Web框架的集成方法如下： Tornado Flask Django aioh�p 需要在Tornado应用中引入两个 RequestHandler , 一个 RequestHandler 用 来提供前端静态文件，另一个 web.StaticFileHandler, {"path": STATIC_PATH, 'default_filename': 'index.html'}) # 前端静态文件托管 ]) application.listen(port=80, address='localhost') tornado.ioloop.IOLoop.current().start() org/en/stable/websocket.html#tornado.websocket.WebSocketHandler] ， 并 将其绑定在 /tool/io 路径下；同时将PyWebIO的静态文件使用 tornado.web.StaticFileHandler [https://www.tornadoweb.org/en/stable/web.html? highlight=Stati

Flask、Tornado、Django 和 aiohttp Web 框架的集成。 与 Web 框架集成需要完成两部分配置：托管 PyWebIO 前端静态文件；暴露 PyWebIO 后端接口。这其中需 要注意前端页面和后端接口的路径约定，以及前端静态文件与后端接口分开部署时因为跨域而需要的特别设 置。 22 Chapter 4. Documentation PyWebIO, 发布 1.0.3 框架的集成方法如下： Tornado Flask Django aiohttp 需要在 Tornado 应用中引入两个 RequestHandler , 一个 RequestHandler 用来提供前端静态文件，另一 个 RequestHandler 用来和浏览器进行 WebSocket 通讯: import tornado.ioloop import tornado.web from pywebio (r"/tool/(.*)", tornado.web.StaticFileHandler, {"path": STATIC_PATH, 'default_filename': 'index.html'}) # 前端静态文件托 管 ]) application.listen(port=80, address='localhost') tornado.ioloop.IOLoop.current().start()

成两件事情：托管PyWebIO静态文件；暴露PyWebIO后端接口。 这其中需要注 意前端页面和后端接口的路径约定，以及前端静态文件与后端接口分开部署时 因为跨域而需要的特别设置。 不同Web框架的集成方法如下： Tornado Flask Django aioh�p 需要在Tornado应用中引入两个 RequestHandler , 一个 RequestHandler 用 来提供静态的前端文件，另一个 webio_handler(task_func) 来获得PyWebIO和浏览器进行通 讯的Tornado RequestHandler ， 并将其绑定在 /tool/io 路径下；同时将 PyWebIO的静态文件使用 tornado.web.StaticFileHandler 托管到 /tool/(.*) 路径下。 启动Tornado服务后，访问 http://localhost/tool/ 即可使用PyWebIO服务 如果你的Tornado应用处在反向代理(比如Nginx)之后， 可能需要特别配 置反向代理来支持WebSocket协议，这里 有一个Nginx配置WebSocket的 例子。 需要添加两个PyWebIO相关的路由：一个用来提供静态的前端文件，另一 个用来和浏览器进行Http通讯: from pywebio.platform.flask import webio_view from pywebio import STATIC_PATH

PyWebIO 静态文件；暴露 PyWebIO 后端接口。这其中需要注意前端页面和后端接口的路径约定，以及前端静态文件与 后端接口分开部署时因为跨域而需要的特别设置。 不同 Web 框架的集成方法如下： Tornado Flask Django aiohttp 需要在 Tornado 应用中引入两个 RequestHandler , 一个 RequestHandler 用来提供静态的前端文件，另 用webio_handler(task_func) 来 获 得 PyWebIO 和 浏 览 器 进 行 通 讯 的 Tornado RequestHandler ，并将其绑定在 /tool/io 路径下；同时将 PyWebIO 的静态文件使用 tornado.web. StaticFileHandler 托管到 /tool/(.*) 路径下。启动 Tornado 服务后，访问 http://localhost/ tool/ 即可使用 Nginx) 之后，可能需要特别配置反向代理来支持 WebSocket 协议，这里 有一个 Nginx 配置 WebSocket 的例子。 需要添加两个 PyWebIO 相关的路由：一个用来提供静态的前端文件，另一个用来和浏览器进行 Http 通讯: from pywebio.platform.flask import webio_view from pywebio import STATIC_PATH

PyWebIO静态资源的托管 PyWebIO默认使用CDN来获取前端的静态资源，如果要将PyWebIO应用部署到 离线环境中，需要自行托管静态文件， 并将 webio_view() 或 webio_handler() 的 cdn 参数设置为 False 。 cdn=False 时需要将静态资源托管在和PyWebIO应用同级的目录下。 同时，也 可以通过 cdn 参数直接设置PyWebIO静态资源的部署目录。 参数直接设置PyWebIO静态资源的部署目录。 PyWebIO的静态文件的路径保存在 pywebio.STATIC_PATH 中，可使用命令 python3 -c "import pywebio; print(pywebio.STATIC_PATH)" 将其打印出来。 注解 使用 start_server() 启动的应用，如果将 cdn 参数设置为 False ，会自动启 动一个本地的静态资源托管服务，无需手动托管。 基于协程的会话 来自定义索引页面，其接收请求的文件夹路径作为参 数，返回页面HTML字符串。你可以在文件夹中创建一 个 index.py PyWebIO应用文件来重写文件夹的索引页。 static_dir (str) – 应用静态文件目录。目录下的文件可以 通过 http://:/static/files 访问。例如 http_static_dir 路径下存在文件 A/B.jpg ，则其URL为

PyWebIO静态资源的托管 PyWebIO默认使用CDN来获取前端的静态资源，如果要将PyWebIO应用部署到 离线环境中，需要自行托管静态文件， 并将 webio_view() 或 webio_handler() 的 cdn 参数设置为 False 。 cdn=False 时需要将静态资源托管在和PyWebIO应用同级的目录下。 同时，也 可以通过 cdn 参数直接设置PyWebIO静态资源的部署目录。 参数直接设置PyWebIO静态资源的部署目录。 PyWebIO的静态文件的路径保存在 pywebio.STATIC_PATH 中，可使用命令 python3 -c "import pywebio; print(pywebio.STATIC_PATH)" 将其打印出来。 注解 使用 start_server() 启动的应用，如果将 cdn 参数设置为 False ，会自动启 动一个本地的静态资源托管服务，无需手动托管。 基于协程的会话 来自定义索引页面，其接收请求的文件夹路径作为参 数，返回页面HTML字符串。你可以在文件夹中创建一 个 index.py PyWebIO应用文件来重写文件夹的索引页。 static_dir (str) – 应用静态文件目录。目录下的文件可以 通过 http://:/static/files 访问。例如 http_static_dir 路径下存在文件 A/B.jpg ，则其URL为

PyWebIO静态资源的托管 PyWebIO默认使用CDN来获取前端的静态资源，如果要将PyWebIO应用部署到 离线环境中，需要自行托管静态文件， 并将 webio_view() 或 webio_handler() 的 cdn 参数设置为 False 。 cdn=False 时需要将静态资源托管在和PyWebIO应用同级的目录下。 同时，也 可以通过 cdn 参数直接设置PyWebIO静态资源的URL目录。 参数直接设置PyWebIO静态资源的URL目录。 PyWebIO的静态文件的路径保存在 pywebio.STATIC_PATH 中，可使用命令 python3 -c "import pywebio; print(pywebio.STATIC_PATH)" 将其打印出来。 注解 使用 start_server() 启动的应用，如果将 cdn 参数设置为 False ，会自动启 动一个本地的静态资源托管服务，无需手动托管。 基于协程的会话 来自定义索引页面，其接收请求的文件夹路径作为参 数，返回页面HTML字符串。你可以在文件夹中创建一 个 index.py PyWebIO应用文件来重写文件夹的索引页。 static_dir (str) – 应用静态文件目录。目录下的文件可以 通过 http://:/static/files 访问。例如 http_static_dir 路径下存在文件 A/B.jpg ，则其URL为

PyWebIO静态资源的托管 PyWebIO默认使用CDN来获取前端的静态资源，如果要将PyWebIO应用部署到 离线环境中，需要自行托管静态文件， 并将 webio_view() 或 webio_handler() 的 cdn 参数设置为 False 。 cdn=False 时需要将静态资源托管在和PyWebIO应用同级的目录下。 同时，也 可以通过 cdn 参数直接设置PyWebIO静态资源的URL目录。 参数直接设置PyWebIO静态资源的URL目录。 PyWebIO的静态文件的路径保存在 pywebio.STATIC_PATH 中，可使用命令 python3 -c "import pywebio; print(pywebio.STATIC_PATH)" 将其打印出来。 注解 使用 start_server() 启动的应用，如果将 cdn 参数设置为 False ，会自动启 动一个本地的静态资源托管服务，无需手动托管。 基于协程的会话 来自定义索引页面，其接收请求的文件夹路径作为参 数，返回页面HTML字符串。你可以在文件夹中创建一 个 index.py PyWebIO应用文件来重写文件夹的索引页。 static_dir (str) – 应用静态文件目录。目录下的文件可以 通过 http://:/static/files 访问。例如 http_static_dir 路径下存在文件 A/B.jpg ，则其URL为