build

README

TeaWeb - 可视化的Web代理服务

TeaWeb是一款集静态资源、缓存、代理、统计、监控于一体的可视化智能WebServer。

TeaWeb使用Go语言实现，在高可定制化前提下，保证高性能、高并发。

架构

             |--------------|       |----------------------------| 
Client  <->  | TeaWeb:7777  |  <->  | Nginx, Apache, Tomcat,     |
             |--------------|       | Fastcgi, Static Files, ... |
                  |                 |----------------------------|
                  |
                  |
             |-------------|        |-------------|
             |  Web        |        | [Plugins]   | 
             |  Proxy      |  <--   |  Apps       |
             |  Log        |        |  Widgets    |
             |  Monitor    |        |  Filters    |
             |  Statistics |        |-------------|
             |  Security   |
             |  Cache      |
             |  ...        |
             |-------------|

故事

在无数的深夜里，我们不停地下载、安装各式各样的产品：监控是一套、统计是一套、日志收集又是一套。。。

大量不同的开源组合，固然免费，但又要去学习每一套软件如何使用，花了很多时间，做了很多事情之后，尝试各种不同的配置，你会惊奇地发现，自己的系统并没有因此而变得强壮而稳定。

TeaWeb 不是为了做一个很强大的集各种功能于一身的管理系统，而是做一个能让程序员、Linux系统管理员、测试工程师，喝着茶，唱着歌，就能把事情完成的一个智能化的简单易用的产品。

何为"智能化"？TeaWeb会智能发现软件服务、智能提醒软件状态、智能提供性能优化建议，无需太多的配置，当你启动的时候，一切都为你准备好了。

预览

已经构建好的版本

在这里查看编译好的Release版本，可以直接下载运行。

快速启动

注意 要运行TeaWeb需要你安装MongoDB

1. 下载对应的Release版本，目前支持MacOS(darwin)、Linux(32bit/64bit)、Windows(32bit/64bit)三种操作系统；
2. 使用unzip解压到某个目录，比如 teaweb-v0.0.1/；
3. 然后执行：

   cd teaweb-v0.0.1/
   bin/teaweb start
   

4. 如果没有出现错误的话，可以在浏览器中访问：

   http://127.0.0.1:7777
   

   其中127.0.0.1可能需要换成你服务器的IP，而且我们默认使用了7777端口（可以在configs/server.conf中修改），如果访问遇到了问题，请检查防火墙设置；
5. 使用用户名admin和密码123456登录，可以在configs/admin.conf中修改这些信息，也可以在设置界面中修改。

构建自己的版本

1. 从 https://github.com/TeaWeb/build 中下载项目，放到本地磁盘上；
2. 设置全局变量GOPATH为项目目录路径；
3. cd 到 src/main 目录
4. 执行 init.sh 初始化项目，如果下载中出现网络错误，可以尝试多次运行此脚本；
5. 执行 run.sh 启动项目，或者运行 build-[系统版本].sh 构建可执行文件；
6. 在浏览器中访问 http://127.0.0.1:7777 。

扩展TeaWeb

• 如何实现自己的插件

文档

点这里进入文档，持续完善中

在线演示

点击这里查看在线演示的版本

报告问题

请在 https://github.com/TeaWeb/build/issues 报告你所遇到的问题，或者加入QQ群199435611跟大家一起讨论.

相关源码

• 主项目Go语言源码
• 插件Go语言源码
• UserAgent Parser

开发路线图

• v0.1 [当前]实现基础的代理、日志、统计、缓存、服务探针等功能
• v0.2 增强系统稳定性
• v0.3 增加本地日志收集
• v0.4 增加本地服务监控
• v0.5 增强系统稳定性
• v0.6 增加分布式的Agent
• v0.7 增强系统稳定性、性能
• v1.0 正式发布全功能版本
• v2.0 打通运行系统、应用、代码之间的联系

贡献

想参与项目贡献？我们目前有以下工作需要完成：

• 安装打包：我们需要实现docker、yum、apt、npm、brew、composer、gradle等安装方式
• 文档：仍然有大量的文档需要补充
• 本地服务探测：需要书写和测试大量的常用的服务探测规则
• 独立子项目：我们希望将项目分离出多个子项目进行，如果你有兴趣，可以研究：GeoIP分析、UserAgent分析、CGI协议、日志分析、文件识别等独立项目，我们可以整合进项目
• 报告问题：有问题报告给我们也是参与贡献的一环，你可以在这里提问题，或者加入QQ群（199435611）一起讨论

感谢

• Semantic UI - 一个非常好用的UI组件库
• Vue.js - 支持双向绑定的DOM操作库
• Axios - 一个好用的HTTP客户端
• echarts - 一个很酷炫的图表库
• geolite - Geo-IP数据库
• BrowserScope - 社区驱动的Web浏览器信息聚合平台
• Array.js - 帮助开发人员更优雅地操作Javascript数组
• gofcgi - golang client for fastcgi
• go msgpack - Go语言版本的msgpack
• go psutil - Go语言版本的psutil
• CodeMirror - 一个很好的在线代码编辑器
• clipboard - Javascript控制剪切板
• go-pinyin - Go语言实现的汉字转拼音